ansible-collections/community.docker
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.docker.git synced 2025-12-15 19:42:06 +00:00
Code Packages Projects Releases Wiki Activity
66168ae3be
community.docker/branch/stable-4/changelog.html
felixfontein 66168ae3be deploy: ac397b7dd4
2025-12-06 21:46:07 +00:00

3111 lines
321 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Community.Docker Release Notes &mdash; Community.Docker Collection documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=41de9001" />
<link rel="stylesheet" type="text/css" href="_static/css/ansible.css?v=b54c304f" />
<link rel="stylesheet" type="text/css" href="_static/antsibull-minimal.css" />
<link rel="stylesheet" type="text/css" href="_static/css/rtd-ethical-ads.css?v=289b023e" />
<link rel="shortcut icon" href="_static/images/Ansible-Mark-RGB_Black.png"/>
<script src="_static/jquery.js?v=5d32c60e"></script>
<script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
<script src="_static/documentation_options.js?v=7f41d439"></script>
<script src="_static/doctools.js?v=9bcbadda"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Docker Guide" href="docsite/scenario_guide.html" />
<link rel="prev" title="Community.Docker" href="index.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
</head>
<body class="wy-body-for-nav"><!-- extra body elements for Ansible beyond RTD Sphinx Theme -->
<div class="DocSite-globalNav ansibleNav">
<ul>
<li><a href="https://www.ansible.com/blog" target="_blank">Blog</a></li>
<li><a href="https://forum.ansible.com/" target="_blank">Ansible community forum</a></li>
<li><a href="https://docs.ansible.com/" target="_blank">Documentation</a></li>
</ul>
</div>
<a class="DocSite-nav" href="https://ansible-collections.github.io/community.docker/branch/main/" style="padding-bottom: 30px;">
<img class="DocSiteNav-logo"
src="_static/images/Ansible-Mark-RGB_White.png"
alt="Ansible Logo">
<div class="DocSiteNav-title">Community.Docker Collection Docs</div>
</a>
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home">
Community.Docker Collection
</a><!--- Based on https://github.com/rtfd/sphinx_rtd_theme/pull/438/files -->
<div class="version">
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<label class="sr-only" for="q">Search docs:</label>
<input type="text" class="st-default-search-input" id="q" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Community.Docker Release Notes</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-5">v4.8.5</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#release-summary">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#bugfixes">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-4">v4.8.4</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id1">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id2">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-3">v4.8.3</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id3">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id4">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#known-issues">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-2">v4.8.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id5">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id6">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-1">v4.8.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id7">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#minor-changes">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id8">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-8-0">v4.8.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id9">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id10">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id11">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-7-0">v4.7.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id12">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id13">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id14">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-6-2">v4.6.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id15">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id16">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-6-1">v4.6.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id17">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id18">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-6-0">v4.6.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id19">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id20">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-5-2">v4.5.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id21">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id22">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-5-1">v4.5.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id23">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id24">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-5-0">v4.5.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id25">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id26">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-4-0">v4.4.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id27">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id28">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#new-modules">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-3-1">v4.3.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id29">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id30">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-3-0">v4.3.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id31">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id32">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-2-0">v4.2.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id33">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id34">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id35">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-1-0">v4.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id36">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id37">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id38">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-0-1">v4.0.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id39">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id40">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v4-0-0">v4.0.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id41">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id42">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#breaking-changes-porting-guide">Breaking Changes / Porting Guide</a></li>
<li class="toctree-l3"><a class="reference internal" href="#removed-features-previously-deprecated">Removed Features (previously deprecated)</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-13-1">v3.13.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id43">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id44">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-13-0">v3.13.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id45">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id46">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-12-2">v3.12.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id47">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id48">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-12-1">v3.12.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id49">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#deprecated-features">Deprecated Features</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-12-0">v3.12.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id50">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id51">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id52">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id53">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-11-0">v3.11.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id54">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id55">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-10-4">v3.10.4</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id56">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id57">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-10-3">v3.10.3</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id58">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id59">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-10-2">v3.10.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id60">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id61">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-10-1">v3.10.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id62">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id63">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id64">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-10-0">v3.10.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id65">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id66">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id67">Deprecated Features</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-9-0">v3.9.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id68">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id69">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id70">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-8-1">v3.8.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id71">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#security-fixes">Security Fixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id72">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-8-0">v3.8.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id73">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id74">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id75">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-7-0">v3.7.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id76">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id77">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id78">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id79">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-6-0">v3.6.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id80">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#major-changes">Major Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id81">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id82">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id83">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-5-0">v3.5.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id84">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id85">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id86">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id87">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-11">v3.4.11</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id88">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id89">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-10">v3.4.10</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id90">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id91">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-9">v3.4.9</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id92">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id93">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-8">v3.4.8</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id94">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id95">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-7">v3.4.7</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id96">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id97">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-6">v3.4.6</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id98">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id99">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id100">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-5">v3.4.5</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id101">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id102">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-4">v3.4.4</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id103">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id104">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id105">Known Issues</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-3">v3.4.3</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id106">Release Summary</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-2">v3.4.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id107">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id108">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-1">v3.4.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id109">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id110">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-4-0">v3.4.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id111">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id112">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id113">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id114">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-3-2">v3.3.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id115">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id116">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-3-1">v3.3.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id117">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id118">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-3-0">v3.3.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id119">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id120">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id121">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-2-2">v3.2.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id122">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id123">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-2-1">v3.2.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id124">Release Summary</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-2-0">v3.2.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id125">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id126">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id127">Deprecated Features</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-1-0">v3.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id128">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id129">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-0-2">v3.0.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id130">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id131">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-0-1">v3.0.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id132">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id133">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v3-0-0">v3.0.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id134">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id135">Major Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id136">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id137">Breaking Changes / Porting Guide</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id138">Removed Features (previously deprecated)</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id139">Security Fixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id140">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-7-0">v2.7.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id141">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id142">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id143">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id144">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-6-0">v2.6.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id145">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id146">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id147">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id148">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-5-1">v2.5.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id149">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id150">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-5-0">v2.5.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id151">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id152">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-4-0">v2.4.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id153">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id154">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id155">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-3-0">v2.3.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id156">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id157">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id158">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-2-1">v2.2.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id159">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id160">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-2-0">v2.2.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id161">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id162">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id163">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-1-1">v2.1.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id164">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id165">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-1-0">v2.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id166">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id167">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id168">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-0-2">v2.0.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id169">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id170">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-0-1">v2.0.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id171">Release Summary</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v2-0-0">v2.0.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id172">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id173">Breaking Changes / Porting Guide</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id174">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id175">Removed Features (previously deprecated)</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-10-0">v1.10.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id176">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id177">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-9-1">v1.9.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id178">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id179">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-9-0">v1.9.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id180">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id181">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id182">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id183">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#new-plugins">New Plugins</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#connection">Connection</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-8-0">v1.8.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id184">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id185">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id186">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-7-0">v1.7.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id187">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id188">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-6-1">v1.6.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id189">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id190">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-6-0">v1.6.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id191">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id192">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id193">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id194">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-5-0">v1.5.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id195">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id196">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id197">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id198">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-4-0">v1.4.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id199">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id200">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id201">Breaking Changes / Porting Guide</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id202">Security Fixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id203">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-3-0">v1.3.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id204">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id205">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id206">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id207">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-2-2">v1.2.2</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id208">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id209">Security Fixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-2-1">v1.2.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id210">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id211">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-2-0">v1.2.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id212">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id213">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id214">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-1-0">v1.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id215">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id216">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id217">Deprecated Features</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id218">Bugfixes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id219">New Plugins</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#id220">Connection</a></li>
<li class="toctree-l4"><a class="reference internal" href="#inventory">Inventory</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#id221">New Modules</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-0-1">v1.0.1</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id222">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id223">Bugfixes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v1-0-0">v1.0.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id224">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id225">Minor Changes</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#v0-1-0">v0.1.0</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id226">Release Summary</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id227">Minor Changes</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id228">Removed Features (previously deprecated)</a></li>
<li class="toctree-l3"><a class="reference internal" href="#id229">Bugfixes</a></li>
</ul>
</li>
</ul>
</li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="docsite/scenario_guide.html">Docker Guide</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="current_container_facts_module.html">community.docker.current_container_facts module – Return facts about whether the module runs in a container</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_compose_v2_module.html">community.docker.docker_compose_v2 module – Manage multi-container Docker applications with Docker Compose CLI plugin</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_compose_v2_exec_module.html">community.docker.docker_compose_v2_exec module – Run command in a container of a Compose service</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_compose_v2_pull_module.html">community.docker.docker_compose_v2_pull module – Pull a Docker compose project</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_compose_v2_run_module.html">community.docker.docker_compose_v2_run module – Run command in a new container of a Compose service</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_config_module.html">community.docker.docker_config module – Manage docker configs</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_container_module.html">community.docker.docker_container module – manage Docker containers</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_container_copy_into_module.html">community.docker.docker_container_copy_into module – Copy a file into a Docker container</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_container_exec_module.html">community.docker.docker_container_exec module – Execute command in a docker container</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_container_info_module.html">community.docker.docker_container_info module – Retrieves facts about docker container</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_context_info_module.html">community.docker.docker_context_info module – Retrieve information on Docker contexts for the current user</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_host_info_module.html">community.docker.docker_host_info module – Retrieves facts about docker host and lists of objects of the services</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_module.html">community.docker.docker_image module – Manage docker images</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_build_module.html">community.docker.docker_image_build module – Build Docker images using Docker buildx</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_export_module.html">community.docker.docker_image_export module – Export (archive) Docker images</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_info_module.html">community.docker.docker_image_info module – Inspect docker images</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_load_module.html">community.docker.docker_image_load module – Load docker image(s) from archives</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_pull_module.html">community.docker.docker_image_pull module – Pull Docker images from registries</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_push_module.html">community.docker.docker_image_push module – Push Docker images to registries</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_remove_module.html">community.docker.docker_image_remove module – Remove Docker images</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_image_tag_module.html">community.docker.docker_image_tag module – Tag Docker images with new names and/or tags</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_login_module.html">community.docker.docker_login module – Log into a Docker registry</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_network_module.html">community.docker.docker_network module – Manage Docker networks</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_network_info_module.html">community.docker.docker_network_info module – Retrieves facts about docker network</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_node_module.html">community.docker.docker_node module – Manage Docker Swarm node</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_node_info_module.html">community.docker.docker_node_info module – Retrieves facts about docker swarm node from Swarm Manager</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_plugin_module.html">community.docker.docker_plugin module – Manage Docker plugins</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_prune_module.html">community.docker.docker_prune module – Allows to prune various docker objects</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_secret_module.html">community.docker.docker_secret module – Manage docker secrets</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_stack_module.html">community.docker.docker_stack module – docker stack module</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_stack_info_module.html">community.docker.docker_stack_info module – Return information on all docker stacks</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_stack_task_info_module.html">community.docker.docker_stack_task_info module – Return information of the tasks on a docker stack</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_swarm_module.html">community.docker.docker_swarm module – Manage Swarm cluster</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_swarm_info_module.html">community.docker.docker_swarm_info module – Retrieves facts about Docker Swarm cluster</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_swarm_service_module.html">community.docker.docker_swarm_service module – docker swarm service</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_swarm_service_info_module.html">community.docker.docker_swarm_service_info module – Retrieves information about docker services from a Swarm Manager</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_volume_module.html">community.docker.docker_volume module – Manage Docker volumes</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_volume_info_module.html">community.docker.docker_volume_info module – Retrieve facts about Docker volumes</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="docker_connection.html">community.docker.docker connection – Run tasks in docker containers</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_api_connection.html">community.docker.docker_api connection – Run tasks in docker containers</a></li>
<li class="toctree-l1"><a class="reference internal" href="nsenter_connection.html">community.docker.nsenter connection – execute on host running controller container</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="docker_containers_inventory.html">community.docker.docker_containers inventory – Ansible dynamic inventory plugin for Docker containers</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_machine_inventory.html">community.docker.docker_machine inventory – Docker Machine inventory source</a></li>
<li class="toctree-l1"><a class="reference internal" href="docker_swarm_inventory.html">community.docker.docker_swarm inventory – Ansible dynamic inventory plugin for Docker swarm nodes</a></li>
</ul>
<!-- extra nav elements for Ansible beyond RTD Sphinx Theme -->
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Community.Docker Collection</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item active">Community.Docker Release Notes</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="community-docker-release-notes">
<span id="changelog-for-community-docker"></span><h1><a class="toc-backref" href="#id230" role="doc-backlink">Community.Docker Release Notes</a><a class="headerlink" href="#community-docker-release-notes" title="Link to this heading"></a></h1>
<nav class="contents" id="topics">
<p class="topic-title">Topics</p>
<ul class="simple">
<li><p><a class="reference internal" href="#community-docker-release-notes" id="id230">Community.Docker Release Notes</a></p>
<ul>
<li><p><a class="reference internal" href="#v4-8-5" id="id231">v4.8.5</a></p>
<ul>
<li><p><a class="reference internal" href="#release-summary" id="id232">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#bugfixes" id="id233">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-8-4" id="id234">v4.8.4</a></p>
<ul>
<li><p><a class="reference internal" href="#id1" id="id235">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id2" id="id236">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-8-3" id="id237">v4.8.3</a></p>
<ul>
<li><p><a class="reference internal" href="#id3" id="id238">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id4" id="id239">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#known-issues" id="id240">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-8-2" id="id241">v4.8.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id5" id="id242">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id6" id="id243">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-8-1" id="id244">v4.8.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id7" id="id245">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#minor-changes" id="id246">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id8" id="id247">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-8-0" id="id248">v4.8.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id9" id="id249">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id10" id="id250">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id11" id="id251">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-7-0" id="id252">v4.7.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id12" id="id253">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id13" id="id254">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id14" id="id255">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-6-2" id="id256">v4.6.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id15" id="id257">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id16" id="id258">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-6-1" id="id259">v4.6.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id17" id="id260">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id18" id="id261">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-6-0" id="id262">v4.6.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id19" id="id263">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id20" id="id264">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-5-2" id="id265">v4.5.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id21" id="id266">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id22" id="id267">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-5-1" id="id268">v4.5.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id23" id="id269">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id24" id="id270">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-5-0" id="id271">v4.5.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id25" id="id272">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id26" id="id273">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-4-0" id="id274">v4.4.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id27" id="id275">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id28" id="id276">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#new-modules" id="id277">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-3-1" id="id278">v4.3.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id29" id="id279">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id30" id="id280">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-3-0" id="id281">v4.3.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id31" id="id282">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id32" id="id283">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-2-0" id="id284">v4.2.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id33" id="id285">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id34" id="id286">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id35" id="id287">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-1-0" id="id288">v4.1.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id36" id="id289">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id37" id="id290">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id38" id="id291">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-0-1" id="id292">v4.0.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id39" id="id293">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id40" id="id294">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v4-0-0" id="id295">v4.0.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id41" id="id296">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id42" id="id297">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#breaking-changes-porting-guide" id="id298">Breaking Changes / Porting Guide</a></p></li>
<li><p><a class="reference internal" href="#removed-features-previously-deprecated" id="id299">Removed Features (previously deprecated)</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-13-1" id="id300">v3.13.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id43" id="id301">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id44" id="id302">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-13-0" id="id303">v3.13.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id45" id="id304">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id46" id="id305">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-12-2" id="id306">v3.12.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id47" id="id307">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id48" id="id308">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-12-1" id="id309">v3.12.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id49" id="id310">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#deprecated-features" id="id311">Deprecated Features</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-12-0" id="id312">v3.12.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id50" id="id313">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id51" id="id314">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id52" id="id315">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id53" id="id316">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-11-0" id="id317">v3.11.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id54" id="id318">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id55" id="id319">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-10-4" id="id320">v3.10.4</a></p>
<ul>
<li><p><a class="reference internal" href="#id56" id="id321">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id57" id="id322">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-10-3" id="id323">v3.10.3</a></p>
<ul>
<li><p><a class="reference internal" href="#id58" id="id324">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id59" id="id325">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-10-2" id="id326">v3.10.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id60" id="id327">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id61" id="id328">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-10-1" id="id329">v3.10.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id62" id="id330">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id63" id="id331">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id64" id="id332">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-10-0" id="id333">v3.10.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id65" id="id334">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id66" id="id335">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id67" id="id336">Deprecated Features</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-9-0" id="id337">v3.9.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id68" id="id338">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id69" id="id339">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id70" id="id340">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-8-1" id="id341">v3.8.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id71" id="id342">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#security-fixes" id="id343">Security Fixes</a></p></li>
<li><p><a class="reference internal" href="#id72" id="id344">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-8-0" id="id345">v3.8.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id73" id="id346">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id74" id="id347">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id75" id="id348">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-7-0" id="id349">v3.7.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id76" id="id350">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id77" id="id351">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id78" id="id352">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id79" id="id353">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-6-0" id="id354">v3.6.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id80" id="id355">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#major-changes" id="id356">Major Changes</a></p></li>
<li><p><a class="reference internal" href="#id81" id="id357">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id82" id="id358">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id83" id="id359">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-5-0" id="id360">v3.5.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id84" id="id361">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id85" id="id362">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id86" id="id363">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id87" id="id364">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-11" id="id365">v3.4.11</a></p>
<ul>
<li><p><a class="reference internal" href="#id88" id="id366">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id89" id="id367">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-10" id="id368">v3.4.10</a></p>
<ul>
<li><p><a class="reference internal" href="#id90" id="id369">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id91" id="id370">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-9" id="id371">v3.4.9</a></p>
<ul>
<li><p><a class="reference internal" href="#id92" id="id372">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id93" id="id373">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-8" id="id374">v3.4.8</a></p>
<ul>
<li><p><a class="reference internal" href="#id94" id="id375">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id95" id="id376">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-7" id="id377">v3.4.7</a></p>
<ul>
<li><p><a class="reference internal" href="#id96" id="id378">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id97" id="id379">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-6" id="id380">v3.4.6</a></p>
<ul>
<li><p><a class="reference internal" href="#id98" id="id381">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id99" id="id382">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id100" id="id383">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-5" id="id384">v3.4.5</a></p>
<ul>
<li><p><a class="reference internal" href="#id101" id="id385">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id102" id="id386">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-4" id="id387">v3.4.4</a></p>
<ul>
<li><p><a class="reference internal" href="#id103" id="id388">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id104" id="id389">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id105" id="id390">Known Issues</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-3" id="id391">v3.4.3</a></p>
<ul>
<li><p><a class="reference internal" href="#id106" id="id392">Release Summary</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-2" id="id393">v3.4.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id107" id="id394">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id108" id="id395">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-1" id="id396">v3.4.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id109" id="id397">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id110" id="id398">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-4-0" id="id399">v3.4.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id111" id="id400">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id112" id="id401">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id113" id="id402">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id114" id="id403">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-3-2" id="id404">v3.3.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id115" id="id405">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id116" id="id406">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-3-1" id="id407">v3.3.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id117" id="id408">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id118" id="id409">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-3-0" id="id410">v3.3.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id119" id="id411">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id120" id="id412">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id121" id="id413">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-2-2" id="id414">v3.2.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id122" id="id415">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id123" id="id416">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-2-1" id="id417">v3.2.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id124" id="id418">Release Summary</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-2-0" id="id419">v3.2.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id125" id="id420">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id126" id="id421">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id127" id="id422">Deprecated Features</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-1-0" id="id423">v3.1.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id128" id="id424">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id129" id="id425">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-0-2" id="id426">v3.0.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id130" id="id427">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id131" id="id428">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-0-1" id="id429">v3.0.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id132" id="id430">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id133" id="id431">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v3-0-0" id="id432">v3.0.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id134" id="id433">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id135" id="id434">Major Changes</a></p></li>
<li><p><a class="reference internal" href="#id136" id="id435">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id137" id="id436">Breaking Changes / Porting Guide</a></p></li>
<li><p><a class="reference internal" href="#id138" id="id437">Removed Features (previously deprecated)</a></p></li>
<li><p><a class="reference internal" href="#id139" id="id438">Security Fixes</a></p></li>
<li><p><a class="reference internal" href="#id140" id="id439">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-7-0" id="id440">v2.7.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id141" id="id441">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id142" id="id442">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id143" id="id443">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id144" id="id444">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-6-0" id="id445">v2.6.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id145" id="id446">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id146" id="id447">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id147" id="id448">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id148" id="id449">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-5-1" id="id450">v2.5.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id149" id="id451">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id150" id="id452">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-5-0" id="id453">v2.5.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id151" id="id454">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id152" id="id455">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-4-0" id="id456">v2.4.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id153" id="id457">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id154" id="id458">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id155" id="id459">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-3-0" id="id460">v2.3.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id156" id="id461">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id157" id="id462">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id158" id="id463">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-2-1" id="id464">v2.2.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id159" id="id465">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id160" id="id466">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-2-0" id="id467">v2.2.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id161" id="id468">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id162" id="id469">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id163" id="id470">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-1-1" id="id471">v2.1.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id164" id="id472">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id165" id="id473">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-1-0" id="id474">v2.1.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id166" id="id475">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id167" id="id476">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id168" id="id477">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-0-2" id="id478">v2.0.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id169" id="id479">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id170" id="id480">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-0-1" id="id481">v2.0.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id171" id="id482">Release Summary</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v2-0-0" id="id483">v2.0.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id172" id="id484">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id173" id="id485">Breaking Changes / Porting Guide</a></p></li>
<li><p><a class="reference internal" href="#id174" id="id486">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id175" id="id487">Removed Features (previously deprecated)</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-10-0" id="id488">v1.10.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id176" id="id489">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id177" id="id490">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-9-1" id="id491">v1.9.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id178" id="id492">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id179" id="id493">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-9-0" id="id494">v1.9.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id180" id="id495">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id181" id="id496">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id182" id="id497">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id183" id="id498">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#new-plugins" id="id499">New Plugins</a></p>
<ul>
<li><p><a class="reference internal" href="#connection" id="id500">Connection</a></p></li>
</ul>
</li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-8-0" id="id501">v1.8.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id184" id="id502">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id185" id="id503">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id186" id="id504">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-7-0" id="id505">v1.7.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id187" id="id506">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id188" id="id507">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-6-1" id="id508">v1.6.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id189" id="id509">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id190" id="id510">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-6-0" id="id511">v1.6.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id191" id="id512">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id192" id="id513">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id193" id="id514">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id194" id="id515">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-5-0" id="id516">v1.5.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id195" id="id517">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id196" id="id518">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id197" id="id519">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id198" id="id520">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-4-0" id="id521">v1.4.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id199" id="id522">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id200" id="id523">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id201" id="id524">Breaking Changes / Porting Guide</a></p></li>
<li><p><a class="reference internal" href="#id202" id="id525">Security Fixes</a></p></li>
<li><p><a class="reference internal" href="#id203" id="id526">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-3-0" id="id527">v1.3.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id204" id="id528">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id205" id="id529">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id206" id="id530">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id207" id="id531">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-2-2" id="id532">v1.2.2</a></p>
<ul>
<li><p><a class="reference internal" href="#id208" id="id533">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id209" id="id534">Security Fixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-2-1" id="id535">v1.2.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id210" id="id536">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id211" id="id537">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-2-0" id="id538">v1.2.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id212" id="id539">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id213" id="id540">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id214" id="id541">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-1-0" id="id542">v1.1.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id215" id="id543">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id216" id="id544">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id217" id="id545">Deprecated Features</a></p></li>
<li><p><a class="reference internal" href="#id218" id="id546">Bugfixes</a></p></li>
<li><p><a class="reference internal" href="#id219" id="id547">New Plugins</a></p>
<ul>
<li><p><a class="reference internal" href="#id220" id="id548">Connection</a></p></li>
<li><p><a class="reference internal" href="#inventory" id="id549">Inventory</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#id221" id="id550">New Modules</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-0-1" id="id551">v1.0.1</a></p>
<ul>
<li><p><a class="reference internal" href="#id222" id="id552">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id223" id="id553">Bugfixes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v1-0-0" id="id554">v1.0.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id224" id="id555">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id225" id="id556">Minor Changes</a></p></li>
</ul>
</li>
<li><p><a class="reference internal" href="#v0-1-0" id="id557">v0.1.0</a></p>
<ul>
<li><p><a class="reference internal" href="#id226" id="id558">Release Summary</a></p></li>
<li><p><a class="reference internal" href="#id227" id="id559">Minor Changes</a></p></li>
<li><p><a class="reference internal" href="#id228" id="id560">Removed Features (previously deprecated)</a></p></li>
<li><p><a class="reference internal" href="#id229" id="id561">Bugfixes</a></p></li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
<section id="v4-8-5">
<h2><a class="toc-backref" href="#id231" role="doc-backlink">v4.8.5</a><a class="headerlink" href="#v4-8-5" title="Link to this heading"></a></h2>
<section id="release-summary">
<h3><a class="toc-backref" href="#id232" role="doc-backlink">Release Summary</a><a class="headerlink" href="#release-summary" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="bugfixes">
<h3><a class="toc-backref" href="#id233" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#bugfixes" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>CLI-based modules - when parsing JSON output fails, also provide standard error output. Also provide information on the command and its result in machine-readable way (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1216">https://github.com/ansible-collections/community.docker/issues/1216</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1221">https://github.com/ansible-collections/community.docker/pull/1221</a>).</p></li>
<li><p>docker_compose_v2* modules - fix Python 2 compatibility when parsing JSON events (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1220">https://github.com/ansible-collections/community.docker/pull/1220</a>).</p></li>
<li><p>docker_compose_v2, docker_compose_v2_pull - adjust parsing from image pull events to changes in Docker Compose 5.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1219">https://github.com/ansible-collections/community.docker/pull/1219</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-8-4">
<h2><a class="toc-backref" href="#id234" role="doc-backlink">v4.8.4</a><a class="headerlink" href="#v4-8-4" title="Link to this heading"></a></h2>
<section id="id1">
<h3><a class="toc-backref" href="#id235" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id1" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id2">
<h3><a class="toc-backref" href="#id236" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id2" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - when the same port is mapped more than once for the same protocol without specifying an interface, a bug caused an invalid value to be passed for the interface (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1213">https://github.com/ansible-collections/community.docker/issues/1213</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1214">https://github.com/ansible-collections/community.docker/pull/1214</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-8-3">
<h2><a class="toc-backref" href="#id237" role="doc-backlink">v4.8.3</a><a class="headerlink" href="#v4-8-3" title="Link to this heading"></a></h2>
<section id="id3">
<h3><a class="toc-backref" href="#id238" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id3" title="Link to this heading"></a></h3>
<p>Bugfix release for Docker 29.</p>
</section>
<section id="id4">
<h3><a class="toc-backref" href="#id239" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id4" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Docker CLI based modules - work around bug in Docker 29.0.0 that caused a breaking change in <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">version</span> <span class="pre">--format</span> <span class="pre">json</span></code> output (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1185">https://github.com/ansible-collections/community.docker/issues/1185</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1187">https://github.com/ansible-collections/community.docker/pull/1187</a>).</p></li>
<li><p>docker_container - fix <code class="docutils literal notranslate"><span class="pre">pull</span></code> idempotency with Docker 29.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1192">https://github.com/ansible-collections/community.docker/pull/1192</a>).</p></li>
<li><p>docker_container - fix handling of exposed port ranges. So far, the module used an undocumented feature of Docker that was removed from Docker 29.0.0, that allowed to pass the range to the deamon and let handle it. Now the module explodes ranges into a list of all contained ports, same as the Docker CLI does. For backwards compatibility with Docker &lt; 29.0.0, it also explodes ranges returned by the API for existing containers so that comparison should only indicate a difference if the ranges actually change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1192">https://github.com/ansible-collections/community.docker/pull/1192</a>).</p></li>
<li><p>docker_container - fix idempotency for IPv6 addresses with Docker 29.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1192">https://github.com/ansible-collections/community.docker/pull/1192</a>).</p></li>
<li><p>docker_image - fix <code class="docutils literal notranslate"><span class="pre">source=pull</span></code> idempotency with Docker 29.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1192">https://github.com/ansible-collections/community.docker/pull/1192</a>).</p></li>
<li><p>docker_image, docker_image_push - adjust image push detection to Docker 29 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1199">https://github.com/ansible-collections/community.docker/pull/1199</a>).</p></li>
<li><p>docker_image_pull - fix idempotency with Docker 29.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1192">https://github.com/ansible-collections/community.docker/pull/1192</a>).</p></li>
<li><p>docker_network - fix idempotency for IPv6 addresses and networks with Docker 29.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1201">https://github.com/ansible-collections/community.docker/pull/1201</a>).</p></li>
</ul>
</section>
<section id="known-issues">
<h3><a class="toc-backref" href="#id240" role="doc-backlink">Known Issues</a><a class="headerlink" href="#known-issues" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - when specifying IPv6 addresses for networks, Docker since version 29 no longer returns the orignal address used when adding a container to a network, but normalizes them. The module will try to normalize IP addresses for comparison, but it uses the <code class="docutils literal notranslate"><span class="pre">ipaddress</span></code> module from the Python 3 standard library for that. When using the module with Python 2, please install the <a class="reference external" href="https://pypi.org/project/ipaddress/">ipaddress backport for Python 2.x</a> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1198">https://github.com/ansible-collections/community.docker/pull/1198</a>).</p></li>
<li><p>docker_image, docker_image_export - idempotency for archiving images depends on whether the image IDs used by the image storage backend correspond to the IDs used in the tarball’s <code class="docutils literal notranslate"><span class="pre">manifest.json</span></code> files. The new default backend in Docker 29 apparently uses image IDs that no longer correspond, whence idempotency no longer works (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1199">https://github.com/ansible-collections/community.docker/pull/1199</a>).</p></li>
<li><p>docker_network - when specifying IPv6 addresses or networks, Docker since version 29 no longer returns the orignal address/network used when creating a network, but normalizes them. The module will try to normalize IP addresses for comparison, but it uses the <code class="docutils literal notranslate"><span class="pre">ipaddress</span></code> module from the Python 3 standard library for that. When using the module with Python 2, please install the <a class="reference external" href="https://pypi.org/project/ipaddress/">ipaddress backport for Python 2.x</a> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1203">https://github.com/ansible-collections/community.docker/pull/1203</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-8-2">
<h2><a class="toc-backref" href="#id241" role="doc-backlink">v4.8.2</a><a class="headerlink" href="#v4-8-2" title="Link to this heading"></a></h2>
<section id="id5">
<h3><a class="toc-backref" href="#id242" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id5" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id6">
<h3><a class="toc-backref" href="#id243" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id6" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker connection plugin - fix crash instead of warning if Docker version does not support <code class="docutils literal notranslate"><span class="pre">remote_user</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1161">https://github.com/ansible-collections/community.docker/pull/1161</a>).</p></li>
<li><p>docker, nsenter connection plugins - fix handling of <code class="docutils literal notranslate"><span class="pre">become</span></code> plugin password prompt handling in case multiple events arrive at the same time (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1158">https://github.com/ansible-collections/community.docker/pull/1158</a>).</p></li>
<li><p>docker_api connection plugin - fix bug that could lead to loss of data when waiting for <code class="docutils literal notranslate"><span class="pre">become</span></code> plugin prompt (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1152">https://github.com/ansible-collections/community.docker/pull/1152</a>).</p></li>
<li><p>docker_compose_v2_exec - fix crash instead of reporting error if <code class="docutils literal notranslate"><span class="pre">detach=true</span></code> and <code class="docutils literal notranslate"><span class="pre">stdin</span></code> is provided (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1161">https://github.com/ansible-collections/community.docker/pull/1161</a>).</p></li>
<li><p>docker_compose_v2_run - fix crash instead of reporting error if <code class="docutils literal notranslate"><span class="pre">detach=true</span></code> and <code class="docutils literal notranslate"><span class="pre">stdin</span></code> is provided (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1161">https://github.com/ansible-collections/community.docker/pull/1161</a>).</p></li>
<li><p>docker_container_exec - fix bug that could lead to loss of stdout/stderr data (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1152">https://github.com/ansible-collections/community.docker/pull/1152</a>).</p></li>
<li><p>docker_container_exec - make <code class="docutils literal notranslate"><span class="pre">detach=true</span></code> work. So far this resulted in no execution being done (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1145">https://github.com/ansible-collections/community.docker/pull/1145</a>).</p></li>
<li><p>docker_plugin - fix diff mode for plugin options (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1146">https://github.com/ansible-collections/community.docker/pull/1146</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-8-1">
<h2><a class="toc-backref" href="#id244" role="doc-backlink">v4.8.1</a><a class="headerlink" href="#v4-8-1" title="Link to this heading"></a></h2>
<section id="id7">
<h3><a class="toc-backref" href="#id245" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id7" title="Link to this heading"></a></h3>
<p>Maintenance release.</p>
</section>
<section id="minor-changes">
<h3><a class="toc-backref" href="#id246" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#minor-changes" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Note that some new code in <code class="docutils literal notranslate"><span class="pre">plugins/module_utils/_six.py</span></code> is MIT licensed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1138">https://github.com/ansible-collections/community.docker/pull/1138</a>).</p></li>
</ul>
</section>
<section id="id8">
<h3><a class="toc-backref" href="#id247" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id8" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Avoid remaining usages of deprecated <code class="docutils literal notranslate"><span class="pre">ansible.module_utils.six</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1133">https://github.com/ansible-collections/community.docker/pull/1133</a>).</p></li>
<li><p>Avoid usage of deprecated <code class="docutils literal notranslate"><span class="pre">ansible.module_utils.six</span></code> in all code that does not have to support Python 2 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1137">https://github.com/ansible-collections/community.docker/pull/1137</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1139">https://github.com/ansible-collections/community.docker/pull/1139</a>).</p></li>
<li><p>Avoid usage of deprecated <code class="docutils literal notranslate"><span class="pre">ansible.module_utils.six</span></code> in some of the code that still supports Python 2 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1138">https://github.com/ansible-collections/community.docker/pull/1138</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-8-0">
<h2><a class="toc-backref" href="#id248" role="doc-backlink">v4.8.0</a><a class="headerlink" href="#v4-8-0" title="Link to this heading"></a></h2>
<section id="id9">
<h3><a class="toc-backref" href="#id249" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id9" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id10">
<h3><a class="toc-backref" href="#id250" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id10" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - support missing fields and new mount types in <code class="docutils literal notranslate"><span class="pre">mounts</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1129">https://github.com/ansible-collections/community.docker/issues/1129</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1134">https://github.com/ansible-collections/community.docker/pull/1134</a>).</p></li>
</ul>
</section>
<section id="id11">
<h3><a class="toc-backref" href="#id251" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id11" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Avoid deprecated functionality in ansible-core 2.20 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1117">https://github.com/ansible-collections/community.docker/pull/1117</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-7-0">
<h2><a class="toc-backref" href="#id252" role="doc-backlink">v4.7.0</a><a class="headerlink" href="#v4-7-0" title="Link to this heading"></a></h2>
<section id="id12">
<h3><a class="toc-backref" href="#id253" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id12" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id13">
<h3><a class="toc-backref" href="#id254" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id13" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm_service - add support for <code class="docutils literal notranslate"><span class="pre">replicated-job</span></code> mode for Swarm services (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/626">https://github.com/ansible-collections/community.docker/issues/626</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1108">https://github.com/ansible-collections/community.docker/pull/1108</a>).</p></li>
</ul>
</section>
<section id="id14">
<h3><a class="toc-backref" href="#id255" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id14" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_image, docker_image_push - work around a bug in Docker 28.3.3 that prevents pushing without authentication to a registry (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1110">https://github.com/ansible-collections/community.docker/pull/1110</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-6-2">
<h2><a class="toc-backref" href="#id256" role="doc-backlink">v4.6.2</a><a class="headerlink" href="#v4-6-2" title="Link to this heading"></a></h2>
<section id="id15">
<h3><a class="toc-backref" href="#id257" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id15" title="Link to this heading"></a></h3>
<p>Bugfix release for Docker Compose 2.39.0+.</p>
</section>
<section id="id16">
<h3><a class="toc-backref" href="#id258" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id16" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - adjust to new dry-run build events in Docker Compose 2.39.0+ (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1101">https://github.com/ansible-collections/community.docker/pull/1101</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-6-1">
<h2><a class="toc-backref" href="#id259" role="doc-backlink">v4.6.1</a><a class="headerlink" href="#v4-6-1" title="Link to this heading"></a></h2>
<section id="id17">
<h3><a class="toc-backref" href="#id260" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id17" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id18">
<h3><a class="toc-backref" href="#id261" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id18" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - handle a (potentially unintentional) breaking change in Docker Compose 2.37.0. Note that <code class="docutils literal notranslate"><span class="pre">ContainerName</span></code> is no longer part of the return value (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1082">https://github.com/ansible-collections/community.docker/issues/1082</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1083">https://github.com/ansible-collections/community.docker/pull/1083</a>).</p></li>
<li><p>docker_container - fix idempotency if <code class="docutils literal notranslate"><span class="pre">command=[]</span></code> and <code class="docutils literal notranslate"><span class="pre">command_handling=correct</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1080">https://github.com/ansible-collections/community.docker/issues/1080</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1085">https://github.com/ansible-collections/community.docker/pull/1085</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-6-0">
<h2><a class="toc-backref" href="#id262" role="doc-backlink">v4.6.0</a><a class="headerlink" href="#v4-6-0" title="Link to this heading"></a></h2>
<section id="id19">
<h3><a class="toc-backref" href="#id263" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id19" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id20">
<h3><a class="toc-backref" href="#id264" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id20" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container_copy_into - add <code class="docutils literal notranslate"><span class="pre">mode_parse</span></code> parameter which determines how <code class="docutils literal notranslate"><span class="pre">mode</span></code> is parsed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1074">https://github.com/ansible-collections/community.docker/pull/1074</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-5-2">
<h2><a class="toc-backref" href="#id265" role="doc-backlink">v4.5.2</a><a class="headerlink" href="#v4-5-2" title="Link to this heading"></a></h2>
<section id="id21">
<h3><a class="toc-backref" href="#id266" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id21" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id22">
<h3><a class="toc-backref" href="#id267" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id22" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - fix version check for <code class="docutils literal notranslate"><span class="pre">assume_yes</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1054">https://github.com/ansible-collections/community.docker/pull/1054</a>).</p></li>
<li><p>docker_compose_v2 - use <code class="docutils literal notranslate"><span class="pre">--yes</span></code> instead of <code class="docutils literal notranslate"><span class="pre">-y</span></code> from Docker Compose 2.34.0 on (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1060">https://github.com/ansible-collections/community.docker/pull/1060</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-5-1">
<h2><a class="toc-backref" href="#id268" role="doc-backlink">v4.5.1</a><a class="headerlink" href="#v4-5-1" title="Link to this heading"></a></h2>
<section id="id23">
<h3><a class="toc-backref" href="#id269" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id23" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id24">
<h3><a class="toc-backref" href="#id270" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id24" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - rename flag for <code class="docutils literal notranslate"><span class="pre">assume_yes</span></code> parameter for <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">up</span></code> to <code class="docutils literal notranslate"><span class="pre">-y</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1054">https://github.com/ansible-collections/community.docker/pull/1054</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-5-0">
<h2><a class="toc-backref" href="#id271" role="doc-backlink">v4.5.0</a><a class="headerlink" href="#v4-5-0" title="Link to this heading"></a></h2>
<section id="id25">
<h3><a class="toc-backref" href="#id272" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id25" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id26">
<h3><a class="toc-backref" href="#id273" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id26" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - add <code class="docutils literal notranslate"><span class="pre">assume_yes</span></code> parameter for <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">up</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1045">https://github.com/ansible-collections/community.docker/pull/1045</a>).</p></li>
<li><p>docker_network - add <code class="docutils literal notranslate"><span class="pre">enable_ipv4</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1047">https://github.com/ansible-collections/community.docker/issues/1047</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1049">https://github.com/ansible-collections/community.docker/pull/1049</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-4-0">
<h2><a class="toc-backref" href="#id274" role="doc-backlink">v4.4.0</a><a class="headerlink" href="#v4-4-0" title="Link to this heading"></a></h2>
<section id="id27">
<h3><a class="toc-backref" href="#id275" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id27" title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<section id="id28">
<h3><a class="toc-backref" href="#id276" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id28" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2_run - the module has a conflict between the type of parameter it expects and the one it tries to sanitize. Fix removes the label sanitization step because they are already validated by the parameter definition (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1034">https://github.com/ansible-collections/community.docker/pull/1034</a>).</p></li>
<li><p>vendored Docker SDK for Python - do not assume that <code class="docutils literal notranslate"><span class="pre">KeyError</span></code> is always for <code class="docutils literal notranslate"><span class="pre">ApiVersion</span></code> when querying version fails (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1033">https://github.com/ansible-collections/community.docker/issues/1033</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1034">https://github.com/ansible-collections/community.docker/pull/1034</a>).</p></li>
</ul>
</section>
<section id="new-modules">
<h3><a class="toc-backref" href="#id277" role="doc-backlink">New Modules</a><a class="headerlink" href="#new-modules" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_context_info - Retrieve information on Docker contexts for the current user.</p></li>
</ul>
</section>
</section>
<section id="v4-3-1">
<h2><a class="toc-backref" href="#id278" role="doc-backlink">v4.3.1</a><a class="headerlink" href="#v4-3-1" title="Link to this heading"></a></h2>
<section id="id29">
<h3><a class="toc-backref" href="#id279" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id29" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id30">
<h3><a class="toc-backref" href="#id280" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id30" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Fix label sanitization code to avoid crashes in case of errors (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1028">https://github.com/ansible-collections/community.docker/issues/1028</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1029">https://github.com/ansible-collections/community.docker/pull/1029</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-3-0">
<h2><a class="toc-backref" href="#id281" role="doc-backlink">v4.3.0</a><a class="headerlink" href="#v4-3-0" title="Link to this heading"></a></h2>
<section id="id31">
<h3><a class="toc-backref" href="#id282" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id31" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id32">
<h3><a class="toc-backref" href="#id283" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id32" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2* modules - determine compose version with <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">version</span></code> and only then fall back to <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">info</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1021">https://github.com/ansible-collections/community.docker/pull/1021</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-2-0">
<h2><a class="toc-backref" href="#id284" role="doc-backlink">v4.2.0</a><a class="headerlink" href="#v4-2-0" title="Link to this heading"></a></h2>
<section id="id33">
<h3><a class="toc-backref" href="#id285" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id33" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id34">
<h3><a class="toc-backref" href="#id286" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id34" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - add <code class="docutils literal notranslate"><span class="pre">ignore_build_events</span></code> option (default value <code class="docutils literal notranslate"><span class="pre">true</span></code>) which allows to (not) ignore build events for change detection (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1005">https://github.com/ansible-collections/community.docker/issues/1005</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/pull/1011">https://github.com/ansible-collections/community.docker/issues/pull/1011</a>).</p></li>
<li><p>docker_image_build - <code class="docutils literal notranslate"><span class="pre">outputs[].name</span></code> can now be a list of strings (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1006">https://github.com/ansible-collections/community.docker/pull/1006</a>).</p></li>
<li><p>docker_image_build - the executed command is now returned in the <code class="docutils literal notranslate"><span class="pre">command</span></code> return value in case of success and some errors (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1006">https://github.com/ansible-collections/community.docker/pull/1006</a>).</p></li>
<li><p>docker_network - added <code class="docutils literal notranslate"><span class="pre">ingress</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/999">https://github.com/ansible-collections/community.docker/pull/999</a>).</p></li>
</ul>
</section>
<section id="id35">
<h3><a class="toc-backref" href="#id287" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id35" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - when using Compose 2.31.0 or newer, revert to the old behavior that image rebuilds, for example if <code class="docutils literal notranslate"><span class="pre">rebuild=always</span></code>, only result in <code class="docutils literal notranslate"><span class="pre">changed</span></code> if a container has been restarted (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1005">https://github.com/ansible-collections/community.docker/issues/1005</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/pull/1011">https://github.com/ansible-collections/community.docker/issues/pull/1011</a>).</p></li>
<li><p>docker_image_build - work around bug resp. very unexpected behavior in Docker buildx that overwrites all image names in <code class="docutils literal notranslate"><span class="pre">--output</span></code> parameters if <code class="docutils literal notranslate"><span class="pre">--tag</span></code> is provided, which the module did by default in the past. The module now only supplies <code class="docutils literal notranslate"><span class="pre">--tag</span></code> if <code class="docutils literal notranslate"><span class="pre">outputs</span></code> is empty. If <code class="docutils literal notranslate"><span class="pre">outputs</span></code> has entries, it will add an additional entry with <code class="docutils literal notranslate"><span class="pre">type=image</span></code> if no entry of <code class="docutils literal notranslate"><span class="pre">type=image</span></code> contains the image name specified by the <code class="docutils literal notranslate"><span class="pre">name</span></code> and <code class="docutils literal notranslate"><span class="pre">tag</span></code> options (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1001">https://github.com/ansible-collections/community.docker/issues/1001</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1006">https://github.com/ansible-collections/community.docker/pull/1006</a>).</p></li>
<li><p>docker_network - added waiting while container actually disconnect from Swarm network (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/999">https://github.com/ansible-collections/community.docker/pull/999</a>).</p></li>
<li><p>docker_network - containers are only reconnected to a network if they really exist (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/999">https://github.com/ansible-collections/community.docker/pull/999</a>).</p></li>
<li><p>docker_network - enabled “force” option in Docker network container disconnect API call (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/999">https://github.com/ansible-collections/community.docker/pull/999</a>).</p></li>
<li><p>docker_swarm_info - do not crash when finding Swarm jobs if <code class="docutils literal notranslate"><span class="pre">services=true</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/1003">https://github.com/ansible-collections/community.docker/issues/1003</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-1-0">
<h2><a class="toc-backref" href="#id288" role="doc-backlink">v4.1.0</a><a class="headerlink" href="#v4-1-0" title="Link to this heading"></a></h2>
<section id="id36">
<h3><a class="toc-backref" href="#id289" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id36" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id37">
<h3><a class="toc-backref" href="#id290" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id37" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_stack - allow to add <code class="docutils literal notranslate"><span class="pre">--detach=false</span></code> option to <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">stack</span> <span class="pre">deploy</span></code> command (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/987">https://github.com/ansible-collections/community.docker/pull/987</a>).</p></li>
</ul>
</section>
<section id="id38">
<h3><a class="toc-backref" href="#id291" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id38" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2_exec, docker_compose_v2_run - fix missing <code class="docutils literal notranslate"><span class="pre">--env</span></code> flag while assembling env arguments (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/992">https://github.com/ansible-collections/community.docker/pull/992</a>).</p></li>
<li><p>docker_host_info - ensure that the module always returns <code class="docutils literal notranslate"><span class="pre">can_talk_to_docker</span></code>, and that it provides the correct value even if <code class="docutils literal notranslate"><span class="pre">api_version</span></code> is specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/993">https://github.com/ansible-collections/community.docker/issues/993</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/995">https://github.com/ansible-collections/community.docker/pull/995</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-0-1">
<h2><a class="toc-backref" href="#id292" role="doc-backlink">v4.0.1</a><a class="headerlink" href="#v4-0-1" title="Link to this heading"></a></h2>
<section id="id39">
<h3><a class="toc-backref" href="#id293" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id39" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id40">
<h3><a class="toc-backref" href="#id294" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id40" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2_run - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_config - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_network - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_node - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_secret - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_swarm - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_swarm_service - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> and <code class="docutils literal notranslate"><span class="pre">container_labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
<li><p>docker_volume - make sure to sanitize <code class="docutils literal notranslate"><span class="pre">labels</span></code> before sending them to the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/985">https://github.com/ansible-collections/community.docker/pull/985</a>).</p></li>
</ul>
</section>
</section>
<section id="v4-0-0">
<h2><a class="toc-backref" href="#id295" role="doc-backlink">v4.0.0</a><a class="headerlink" href="#v4-0-0" title="Link to this heading"></a></h2>
<section id="id41">
<h3><a class="toc-backref" href="#id296" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id41" title="Link to this heading"></a></h3>
<p>Major release with removed deprecated features.</p>
</section>
<section id="id42">
<h3><a class="toc-backref" href="#id297" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id42" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - add <code class="docutils literal notranslate"><span class="pre">renew_anon_volumes</span></code> parameter for <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">up</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/977">https://github.com/ansible-collections/community.docker/pull/977</a>).</p></li>
</ul>
</section>
<section id="breaking-changes-porting-guide">
<h3><a class="toc-backref" href="#id298" role="doc-backlink">Breaking Changes / Porting Guide</a><a class="headerlink" href="#breaking-changes-porting-guide" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the default of <code class="docutils literal notranslate"><span class="pre">image_name_mismatch</span></code> changed from <code class="docutils literal notranslate"><span class="pre">ignore</span></code> to <code class="docutils literal notranslate"><span class="pre">recreate</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
</ul>
</section>
<section id="removed-features-previously-deprecated">
<h3><a class="toc-backref" href="#id299" role="doc-backlink">Removed Features (previously deprecated)</a><a class="headerlink" href="#removed-features-previously-deprecated" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The collection no longer supports ansible-core 2.11, 2.12, 2.13, and 2.14. You need ansible-core 2.15.0 or newer to use community.docker 4.x.y (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
<li><p>The docker_compose module has been removed. Please migrate to community.docker.docker_compose_v2 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">ignore_image</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">image:</span> <span class="pre">ignore</span></code> in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">purge_networks</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">networks:</span> <span class="pre">strict</span></code> in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code> instead and make sure that <code class="docutils literal notranslate"><span class="pre">networks</span></code> is specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
<li><p>various modules and plugins - remove the <code class="docutils literal notranslate"><span class="pre">ssl_version</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/971">https://github.com/ansible-collections/community.docker/pull/971</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-13-1">
<h2><a class="toc-backref" href="#id300" role="doc-backlink">v3.13.1</a><a class="headerlink" href="#v3-13-1" title="Link to this heading"></a></h2>
<section id="id43">
<h3><a class="toc-backref" href="#id301" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id43" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id44">
<h3><a class="toc-backref" href="#id302" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id44" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - improve parsing of dry-run image build operations from JSON events (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/975">https://github.com/ansible-collections/community.docker/issues/975</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/976">https://github.com/ansible-collections/community.docker/pull/976</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-13-0">
<h2><a class="toc-backref" href="#id303" role="doc-backlink">v3.13.0</a><a class="headerlink" href="#v3-13-0" title="Link to this heading"></a></h2>
<section id="id45">
<h3><a class="toc-backref" href="#id304" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id45" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id46">
<h3><a class="toc-backref" href="#id305" role="doc-backlink">New Modules</a><a class="headerlink" href="#id46" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_compose_v2_exec - Run command in a container of a Compose service.</p></li>
<li><p>community.docker.docker_compose_v2_run - Run command in a new container of a Compose service.</p></li>
</ul>
</section>
</section>
<section id="v3-12-2">
<h2><a class="toc-backref" href="#id306" role="doc-backlink">v3.12.2</a><a class="headerlink" href="#v3-12-2" title="Link to this heading"></a></h2>
<section id="id47">
<h3><a class="toc-backref" href="#id307" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id47" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id48">
<h3><a class="toc-backref" href="#id308" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id48" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_prune - fix handling of lists for the filter options (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/961">https://github.com/ansible-collections/community.docker/issues/961</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/966">https://github.com/ansible-collections/community.docker/pull/966</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-12-1">
<h2><a class="toc-backref" href="#id309" role="doc-backlink">v3.12.1</a><a class="headerlink" href="#v3-12-1" title="Link to this heading"></a></h2>
<section id="id49">
<h3><a class="toc-backref" href="#id310" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id49" title="Link to this heading"></a></h3>
<p>Maintenance release with updated documentation and changelog.</p>
</section>
<section id="deprecated-features">
<h3><a class="toc-backref" href="#id311" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#deprecated-features" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The collection deprecates support for all ansible-core versions that are currently End of Life, <a class="reference external" href="https://docs.ansible.com/ansible-core/devel/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix">according to the ansible-core support matrix</a>. This means that the next major release of the collection will no longer support ansible-core 2.11, ansible-core 2.12, ansible-core 2.13, and ansible-core 2.14.</p></li>
</ul>
</section>
</section>
<section id="v3-12-0">
<h2><a class="toc-backref" href="#id312" role="doc-backlink">v3.12.0</a><a class="headerlink" href="#v3-12-0" title="Link to this heading"></a></h2>
<section id="id50">
<h3><a class="toc-backref" href="#id313" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id50" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id51">
<h3><a class="toc-backref" href="#id314" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id51" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker, docker_api connection plugins - allow to determine the working directory when executing commands with the new <code class="docutils literal notranslate"><span class="pre">working_dir</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/943">https://github.com/ansible-collections/community.docker/pull/943</a>).</p></li>
<li><p>docker, docker_api connection plugins - allow to execute commands with extended privileges with the new <code class="docutils literal notranslate"><span class="pre">privileges</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/943">https://github.com/ansible-collections/community.docker/pull/943</a>).</p></li>
<li><p>docker, docker_api connection plugins - allow to pass extra environment variables when executing commands with the new <code class="docutils literal notranslate"><span class="pre">extra_env</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/937">https://github.com/ansible-collections/community.docker/issues/937</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/940">https://github.com/ansible-collections/community.docker/pull/940</a>).</p></li>
<li><p>docker_compose_v2* modules - support Docker Compose 2.29.0’s <code class="docutils literal notranslate"><span class="pre">json</span></code> progress writer to avoid having to parse text output (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/931">https://github.com/ansible-collections/community.docker/pull/931</a>).</p></li>
<li><p>docker_compose_v2_pull - add new options <code class="docutils literal notranslate"><span class="pre">ignore_buildable</span></code>, <code class="docutils literal notranslate"><span class="pre">include_deps</span></code>, and <code class="docutils literal notranslate"><span class="pre">services</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/941">https://github.com/ansible-collections/community.docker/issues/941</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/942">https://github.com/ansible-collections/community.docker/pull/942</a>).</p></li>
<li><p>docker_container - when creating a container, directly pass all networks to connect to to the Docker Daemon for API version 1.44 and newer. This makes creation more efficient and works around a bug in Docker Daemon that does not use the specified MAC address in at least some cases, though only for creation (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/933">https://github.com/ansible-collections/community.docker/pull/933</a>).</p></li>
</ul>
</section>
<section id="id52">
<h3><a class="toc-backref" href="#id315" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id52" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - handle yet another random unstructured error output from pre-2.29.0 Compose versions (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/948">https://github.com/ansible-collections/community.docker/issues/948</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/949">https://github.com/ansible-collections/community.docker/pull/949</a>).</p></li>
<li><p>docker_compose_v2 - make sure that services provided in <code class="docutils literal notranslate"><span class="pre">services</span></code> are appended to the command line after <code class="docutils literal notranslate"><span class="pre">--</span></code> and not before it (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/942">https://github.com/ansible-collections/community.docker/pull/942</a>).</p></li>
<li><p>docker_compose_v2* modules, docker_image_build - provide better error message when required fields are not present in <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">version</span></code> or <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">info</span></code> output. This can happen if Podman is used instead of Docker (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/891">https://github.com/ansible-collections/community.docker/issues/891</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/935">https://github.com/ansible-collections/community.docker/pull/935</a>).</p></li>
<li><p>docker_container - fix idempotency if <code class="docutils literal notranslate"><span class="pre">network_mode=default</span></code> and Docker 26.1.0 or later is used. There was a breaking change in Docker 26.1.0 regarding normalization of <code class="docutils literal notranslate"><span class="pre">NetworkMode</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/934">https://github.com/ansible-collections/community.docker/issues/934</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/936">https://github.com/ansible-collections/community.docker/pull/936</a>).</p></li>
<li><p>docker_container - restore behavior of the module from community.docker 2.x.y that passes the first network to the Docker Deamon while creating the container (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/933">https://github.com/ansible-collections/community.docker/pull/933</a>).</p></li>
<li><p>docker_image_build - fix <code class="docutils literal notranslate"><span class="pre">--output</span></code> parameter composition for <code class="docutils literal notranslate"><span class="pre">type=docker</span></code> and <code class="docutils literal notranslate"><span class="pre">type=image</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/946">https://github.com/ansible-collections/community.docker/issues/946</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/947">https://github.com/ansible-collections/community.docker/pull/947</a>).</p></li>
</ul>
</section>
<section id="id53">
<h3><a class="toc-backref" href="#id316" role="doc-backlink">Known Issues</a><a class="headerlink" href="#id53" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - when specifying a MAC address for a container’s network, and the network is attached after container creation (for example, due to idempotency checks), the MAC address is at least in some cases ignored by the Docker Daemon (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/933">https://github.com/ansible-collections/community.docker/pull/933</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-11-0">
<h2><a class="toc-backref" href="#id317" role="doc-backlink">v3.11.0</a><a class="headerlink" href="#v3-11-0" title="Link to this heading"></a></h2>
<section id="id54">
<h3><a class="toc-backref" href="#id318" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id54" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - add support for <code class="docutils literal notranslate"><span class="pre">device_cgroup_rules</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/910">https://github.com/ansible-collections/community.docker/pull/910</a>).</p></li>
<li><p>docker_container - the new <code class="docutils literal notranslate"><span class="pre">state=healthy</span></code> allows to wait for a container to become healthy on startup. The <code class="docutils literal notranslate"><span class="pre">healthy_wait_timeout</span></code> option allows to configure the maximum time to wait for this to happen (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/890">https://github.com/ansible-collections/community.docker/issues/890</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/921">https://github.com/ansible-collections/community.docker/pull/921</a>).</p></li>
</ul>
</section>
<section id="id55">
<h3><a class="toc-backref" href="#id319" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id55" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2* modules - fix parsing of skipped pull messages for Docker Compose 2.28.x (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/911">https://github.com/ansible-collections/community.docker/issues/911</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/916">https://github.com/ansible-collections/community.docker/pull/916</a>).</p></li>
<li><p>docker_compose_v2*, docker_stack*, docker_image_build modules - using <code class="docutils literal notranslate"><span class="pre">cli_context</span></code> no longer leads to an invalid parameter combination being passed to the corresponding Docker CLI tool, unless <code class="docutils literal notranslate"><span class="pre">docker_host</span></code> is also provided. Combining <code class="docutils literal notranslate"><span class="pre">cli_context</span></code> and <code class="docutils literal notranslate"><span class="pre">docker_host</span></code> is no longer allowed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/892">https://github.com/ansible-collections/community.docker/issues/892</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/895">https://github.com/ansible-collections/community.docker/pull/895</a>).</p></li>
<li><p>docker_container - fix possible infinite loop if <code class="docutils literal notranslate"><span class="pre">removal_wait_timeout</span></code> is set (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/922">https://github.com/ansible-collections/community.docker/pull/922</a>).</p></li>
<li><p>vendored Docker SDK for Python - use <code class="docutils literal notranslate"><span class="pre">LooseVersion</span></code> instead of <code class="docutils literal notranslate"><span class="pre">StrictVersion</span></code> to compare urllib3 versions. This is needed for development versions (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/902">https://github.com/ansible-collections/community.docker/pull/902</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-10-4">
<h2><a class="toc-backref" href="#id320" role="doc-backlink">v3.10.4</a><a class="headerlink" href="#v3-10-4" title="Link to this heading"></a></h2>
<section id="id56">
<h3><a class="toc-backref" href="#id321" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id56" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id57">
<h3><a class="toc-backref" href="#id322" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id57" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - make sure that the module uses the <code class="docutils literal notranslate"><span class="pre">api_version</span></code> parameter (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/881">https://github.com/ansible-collections/community.docker/pull/881</a>).</p></li>
<li><p>docker_compose_v2* modules - there was no check to make sure that one of <code class="docutils literal notranslate"><span class="pre">project_src</span></code> and <code class="docutils literal notranslate"><span class="pre">definition</span></code> is provided. The modules crashed if none were provided (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/885">https://github.com/ansible-collections/community.docker/issues/885</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/886">https://github.com/ansible-collections/community.docker/pull/886</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-10-3">
<h2><a class="toc-backref" href="#id323" role="doc-backlink">v3.10.3</a><a class="headerlink" href="#v3-10-3" title="Link to this heading"></a></h2>
<section id="id58">
<h3><a class="toc-backref" href="#id324" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id58" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id59">
<h3><a class="toc-backref" href="#id325" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id59" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker and nsenter connection plugins, docker_container_exec module - avoid using the deprecated <code class="docutils literal notranslate"><span class="pre">ansible.module_utils.compat.selectors</span></code> module util with Python 3 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/870">https://github.com/ansible-collections/community.docker/issues/870</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/871">https://github.com/ansible-collections/community.docker/pull/871</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-10-2">
<h2><a class="toc-backref" href="#id326" role="doc-backlink">v3.10.2</a><a class="headerlink" href="#v3-10-2" title="Link to this heading"></a></h2>
<section id="id60">
<h3><a class="toc-backref" href="#id327" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id60" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id61">
<h3><a class="toc-backref" href="#id328" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id61" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>vendored Docker SDK for Python - include a fix requests 2.32.2+ compatibility (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/860">https://github.com/ansible-collections/community.docker/issues/860</a>, <a class="reference external" href="https://github.com/psf/requests/issues/6707">https://github.com/psf/requests/issues/6707</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/864">https://github.com/ansible-collections/community.docker/pull/864</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-10-1">
<h2><a class="toc-backref" href="#id329" role="doc-backlink">v3.10.1</a><a class="headerlink" href="#v3-10-1" title="Link to this heading"></a></h2>
<section id="id62">
<h3><a class="toc-backref" href="#id330" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id62" title="Link to this heading"></a></h3>
<p>Hotfix release for requests 2.32.0 compatibility.</p>
</section>
<section id="id63">
<h3><a class="toc-backref" href="#id331" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id63" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>vendored Docker SDK for Python - include a hotfix for requests 2.32.0 compatibility (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/860">https://github.com/ansible-collections/community.docker/issues/860</a>, <a class="reference external" href="https://github.com/docker/docker-py/issues/3256">https://github.com/docker/docker-py/issues/3256</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/861">https://github.com/ansible-collections/community.docker/pull/861</a>).</p></li>
</ul>
</section>
<section id="id64">
<h3><a class="toc-backref" href="#id332" role="doc-backlink">Known Issues</a><a class="headerlink" href="#id64" title="Link to this heading"></a></h3>
<ul>
<li><p>Please note that the fix for requests 2.32.0 included in community.docker 3.10.1 only
fixes problems with the <em>vendored</em> Docker SDK for Python code. Modules and plugins that
use Docker SDK for Python can still fail due to the SDK currently being incompatible
with requests 2.32.0.</p>
<p>If you still experience problems with requests 2.32.0, such as error messages like
<code class="docutils literal notranslate"><span class="pre">Not</span> <span class="pre">supported</span> <span class="pre">URL</span> <span class="pre">scheme</span> <span class="pre">http+docker</span></code>, please restrict requests to <code class="docutils literal notranslate"><span class="pre">&lt;2.32.0</span></code>.</p>
</li>
</ul>
</section>
</section>
<section id="v3-10-0">
<h2><a class="toc-backref" href="#id333" role="doc-backlink">v3.10.0</a><a class="headerlink" href="#v3-10-0" title="Link to this heading"></a></h2>
<section id="id65">
<h3><a class="toc-backref" href="#id334" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id65" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id66">
<h3><a class="toc-backref" href="#id335" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id66" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - adds <code class="docutils literal notranslate"><span class="pre">healthcheck.start_interval</span></code> to support healthcheck start interval setting on containers (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/848">https://github.com/ansible-collections/community.docker/pull/848</a>).</p></li>
<li><p>docker_container - adds <code class="docutils literal notranslate"><span class="pre">healthcheck.test_cli_compatible</span></code> to allow omit test option on containers without remove existing image test (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/847">https://github.com/ansible-collections/community.docker/pull/847</a>).</p></li>
<li><p>docker_image_build - add <code class="docutils literal notranslate"><span class="pre">outputs</span></code> option to allow configuring outputs for the build (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/852">https://github.com/ansible-collections/community.docker/pull/852</a>).</p></li>
<li><p>docker_image_build - add <code class="docutils literal notranslate"><span class="pre">secrets</span></code> option to allow passing secrets to the build (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/852">https://github.com/ansible-collections/community.docker/pull/852</a>).</p></li>
<li><p>docker_image_build - allow <code class="docutils literal notranslate"><span class="pre">platform</span></code> to be a list of platforms instead of only a single platform for multi-platform builds (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/852">https://github.com/ansible-collections/community.docker/pull/852</a>).</p></li>
<li><p>docker_network - adds <code class="docutils literal notranslate"><span class="pre">config_only</span></code> and <code class="docutils literal notranslate"><span class="pre">config_from</span></code> to support creating and using config only networks (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/395">https://github.com/ansible-collections/community.docker/issues/395</a>).</p></li>
<li><p>docker_prune - add new options <code class="docutils literal notranslate"><span class="pre">builder_cache_all</span></code>, <code class="docutils literal notranslate"><span class="pre">builder_cache_filters</span></code>, and <code class="docutils literal notranslate"><span class="pre">builder_cache_keep_storage</span></code>, and a new return value <code class="docutils literal notranslate"><span class="pre">builder_cache_caches_deleted</span></code> for pruning build caches (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/844">https://github.com/ansible-collections/community.docker/issues/844</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/845">https://github.com/ansible-collections/community.docker/issues/845</a>).</p></li>
<li><p>docker_swarm_service - adds <code class="docutils literal notranslate"><span class="pre">sysctls</span></code> to support sysctl settings on swarm services (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/190">https://github.com/ansible-collections/community.docker/issues/190</a>).</p></li>
</ul>
</section>
<section id="id67">
<h3><a class="toc-backref" href="#id336" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id67" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - the Docker Compose v1 module is deprecated and will be removed from community.docker 4.0.0. Please migrate to the <code class="docutils literal notranslate"><span class="pre">community.docker.docker_compose_v2</span></code> module, which works with Docker Compose v2 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/823">https://github.com/ansible-collections/community.docker/issues/823</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/833">https://github.com/ansible-collections/community.docker/pull/833</a>).</p></li>
<li><p>various modules and plugins - the <code class="docutils literal notranslate"><span class="pre">ssl_version</span></code> option has been deprecated and will be removed from community.docker 4.0.0. It has already been removed from Docker SDK for Python 7.0.0, and was only necessary in the past to work around SSL/TLS issues (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/853">https://github.com/ansible-collections/community.docker/pull/853</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-9-0">
<h2><a class="toc-backref" href="#id337" role="doc-backlink">v3.9.0</a><a class="headerlink" href="#v3-9-0" title="Link to this heading"></a></h2>
<section id="id68">
<h3><a class="toc-backref" href="#id338" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id68" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id69">
<h3><a class="toc-backref" href="#id339" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id69" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The EE requirements now include PyYAML, since the <code class="docutils literal notranslate"><span class="pre">docker_compose_v2*</span></code> modules depend on it when the <code class="docutils literal notranslate"><span class="pre">definition</span></code> option is used. This should not have a noticable effect on generated EEs since ansible-core itself depends on PyYAML as well, and ansible-builder explicitly ignores this dependency (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/832">https://github.com/ansible-collections/community.docker/pull/832</a>).</p></li>
<li><p>docker_compose_v2* - the new option <code class="docutils literal notranslate"><span class="pre">check_files_existing</span></code> allows to disable the check for one of the files <code class="docutils literal notranslate"><span class="pre">compose.yaml</span></code>, <code class="docutils literal notranslate"><span class="pre">compose.yml</span></code>, <code class="docutils literal notranslate"><span class="pre">docker-compose.yaml</span></code>, and <code class="docutils literal notranslate"><span class="pre">docker-compose.yml</span></code> in <code class="docutils literal notranslate"><span class="pre">project_src</span></code> if <code class="docutils literal notranslate"><span class="pre">files</span></code> is not specified. This is necessary if a non-standard compose filename is specified through other means, like the <code class="docutils literal notranslate"><span class="pre">COMPOSE_FILE</span></code> environment variable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/838">https://github.com/ansible-collections/community.docker/issues/838</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/839">https://github.com/ansible-collections/community.docker/pull/839</a>).</p></li>
<li><p>docker_compose_v2* modules - allow to provide an inline definition of the compose content instead of having to provide a <code class="docutils literal notranslate"><span class="pre">project_src</span></code> directory with the compose file written into it (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/829">https://github.com/ansible-collections/community.docker/issues/829</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/832">https://github.com/ansible-collections/community.docker/pull/832</a>).</p></li>
<li><p>vendored Docker SDK for Python - remove unused code that relies on functionality deprecated in Python 3.12 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/834">https://github.com/ansible-collections/community.docker/pull/834</a>).</p></li>
</ul>
</section>
<section id="id70">
<h3><a class="toc-backref" href="#id340" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id70" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2* - allow <code class="docutils literal notranslate"><span class="pre">project_src</span></code> to be a relative path, by converting it to an absolute path before using it (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/827">https://github.com/ansible-collections/community.docker/issues/827</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/828">https://github.com/ansible-collections/community.docker/pull/828</a>).</p></li>
<li><p>docker_compose_v2* modules - abort with a nice error message instead of crash when the Docker Compose CLI plugin version is <code class="docutils literal notranslate"><span class="pre">dev</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/825">https://github.com/ansible-collections/community.docker/issues/825</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/826">https://github.com/ansible-collections/community.docker/pull/826</a>).</p></li>
<li><p>inventory plugins - add unsafe wrapper to avoid marking strings that do not contain <code class="docutils literal notranslate"><span class="pre">{</span></code> or <code class="docutils literal notranslate"><span class="pre">}</span></code> as unsafe, to work around a bug in AWX (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/835">https://github.com/ansible-collections/community.docker/pull/835</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-8-1">
<h2><a class="toc-backref" href="#id341" role="doc-backlink">v3.8.1</a><a class="headerlink" href="#v3-8-1" title="Link to this heading"></a></h2>
<section id="id71">
<h3><a class="toc-backref" href="#id342" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id71" title="Link to this heading"></a></h3>
<p>Bugfix release</p>
</section>
<section id="security-fixes">
<h3><a class="toc-backref" href="#id343" role="doc-backlink">Security Fixes</a><a class="headerlink" href="#security-fixes" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_containers, docker_machine, and docker_swarm inventory plugins - make sure all data received from the Docker daemon / Docker machine is marked as unsafe, so remote code execution by obtaining texts that can be evaluated as templates is not possible (<a class="reference external" href="https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/">https://www.die-welt.net/2024/03/remote-code-execution-in-ansible-dynamic-inventory-plugins/</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/815">https://github.com/ansible-collections/community.docker/pull/815</a>).</p></li>
</ul>
</section>
<section id="id72">
<h3><a class="toc-backref" href="#id344" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id72" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - do not fail when non-fatal errors occur. This can happen when pulling an image fails, but then the image can be built for another service. Docker Compose emits an error in that case, but <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">up</span></code> still completes successfully (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/807">https://github.com/ansible-collections/community.docker/issues/807</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/810">https://github.com/ansible-collections/community.docker/pull/810</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/811">https://github.com/ansible-collections/community.docker/pull/811</a>).</p></li>
<li><p>docker_compose_v2* modules - correctly parse <code class="docutils literal notranslate"><span class="pre">Warning</span></code> events emitted by Docker Compose (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/807">https://github.com/ansible-collections/community.docker/issues/807</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/811">https://github.com/ansible-collections/community.docker/pull/811</a>).</p></li>
<li><p>docker_compose_v2* modules - parse <code class="docutils literal notranslate"><span class="pre">logfmt</span></code> warnings emitted by Docker Compose (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/787">https://github.com/ansible-collections/community.docker/issues/787</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/811">https://github.com/ansible-collections/community.docker/pull/811</a>).</p></li>
<li><p>docker_compose_v2_pull - fixing idempotence by checking actual pull progress events instead of service-level pull request when <code class="docutils literal notranslate"><span class="pre">policy=always</span></code>. This stops the module from reporting <code class="docutils literal notranslate"><span class="pre">changed=true</span></code> if no actual change happened when pulling. In check mode, it has to assume that a change happens though (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/813">https://github.com/ansible-collections/community.docker/issues/813</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/814">https://github.com/ansible-collections/community.docker/pull/814</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-8-0">
<h2><a class="toc-backref" href="#id345" role="doc-backlink">v3.8.0</a><a class="headerlink" href="#v3-8-0" title="Link to this heading"></a></h2>
<section id="id73">
<h3><a class="toc-backref" href="#id346" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id73" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id74">
<h3><a class="toc-backref" href="#id347" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id74" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - allow to wait until containers are running/health when running <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span> <span class="pre">up</span></code> with the new <code class="docutils literal notranslate"><span class="pre">wait</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/794">https://github.com/ansible-collections/community.docker/issues/794</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/796">https://github.com/ansible-collections/community.docker/pull/796</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">pull_check_mode_behavior</span></code> option now allows to control the module’s behavior in check mode when <code class="docutils literal notranslate"><span class="pre">pull=always</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/792">https://github.com/ansible-collections/community.docker/issues/792</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/797">https://github.com/ansible-collections/community.docker/pull/797</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">pull</span></code> option now accepts the three values <code class="docutils literal notranslate"><span class="pre">never</span></code>, <code class="docutils literal notranslate"><span class="pre">missing_image</span></code> (default), and <code class="docutils literal notranslate"><span class="pre">never</span></code>, next to the previously valid values <code class="docutils literal notranslate"><span class="pre">true</span></code> (equivalent to <code class="docutils literal notranslate"><span class="pre">always</span></code>) and <code class="docutils literal notranslate"><span class="pre">false</span></code> (equivalent to <code class="docutils literal notranslate"><span class="pre">missing_image</span></code>). This allows the equivalent to <code class="docutils literal notranslate"><span class="pre">--pull=never</span></code> from the Docker command line (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/783">https://github.com/ansible-collections/community.docker/issues/783</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/797">https://github.com/ansible-collections/community.docker/pull/797</a>).</p></li>
</ul>
</section>
<section id="id75">
<h3><a class="toc-backref" href="#id348" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id75" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - do not consider a <code class="docutils literal notranslate"><span class="pre">Waiting</span></code> event as an action/change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/804">https://github.com/ansible-collections/community.docker/pull/804</a>).</p></li>
<li><p>docker_compose_v2 - do not treat service-level pull events as changes to avoid incorrect <code class="docutils literal notranslate"><span class="pre">changed=true</span></code> return value of <code class="docutils literal notranslate"><span class="pre">pull=always</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/802">https://github.com/ansible-collections/community.docker/issues/802</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/803">https://github.com/ansible-collections/community.docker/pull/803</a>).</p></li>
<li><p>docker_compose_v2, docker_compose_v2_pull - fix parsing of pull messages for Docker Compose 2.20.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/785">https://github.com/ansible-collections/community.docker/issues/785</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/786">https://github.com/ansible-collections/community.docker/pull/786</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-7-0">
<h2><a class="toc-backref" href="#id349" role="doc-backlink">v3.7.0</a><a class="headerlink" href="#v3-7-0" title="Link to this heading"></a></h2>
<section id="id76">
<h3><a class="toc-backref" href="#id350" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id76" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id77">
<h3><a class="toc-backref" href="#id351" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id77" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - add <code class="docutils literal notranslate"><span class="pre">scale</span></code> option to allow to explicitly scale services (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/776">https://github.com/ansible-collections/community.docker/pull/776</a>).</p></li>
<li><p>docker_compose_v2, docker_compose_v2_pull - support <code class="docutils literal notranslate"><span class="pre">files</span></code> parameter to specify multiple Compose files (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/772">https://github.com/ansible-collections/community.docker/issues/772</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/775">https://github.com/ansible-collections/community.docker/pull/775</a>).</p></li>
</ul>
</section>
<section id="id78">
<h3><a class="toc-backref" href="#id352" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id78" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose_v2 - properly parse dry-run build events from <code class="docutils literal notranslate"><span class="pre">stderr</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/778">https://github.com/ansible-collections/community.docker/issues/778</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/779">https://github.com/ansible-collections/community.docker/pull/779</a>).</p></li>
<li><p>docker_compose_v2_pull - the module was documented as part of the <code class="docutils literal notranslate"><span class="pre">community.docker.docker</span></code> action group, but was not actually part of it. That has now been fixed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/773">https://github.com/ansible-collections/community.docker/pull/773</a>).</p></li>
</ul>
</section>
<section id="id79">
<h3><a class="toc-backref" href="#id353" role="doc-backlink">New Modules</a><a class="headerlink" href="#id79" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_image_export - Export (archive) Docker images</p></li>
</ul>
</section>
</section>
<section id="v3-6-0">
<h2><a class="toc-backref" href="#id354" role="doc-backlink">v3.6.0</a><a class="headerlink" href="#v3-6-0" title="Link to this heading"></a></h2>
<section id="id80">
<h3><a class="toc-backref" href="#id355" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id80" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
<p>The collection now includes a bunch of new <code class="docutils literal notranslate"><span class="pre">docker_image_*</span></code> modules that move features out of the
rather complex <code class="docutils literal notranslate"><span class="pre">docker_image</span></code> module. These new modules are easier to use and can better declare whether
they support check mode, diff mode, or none of them.</p>
<p>This version also features modules that support the Docker CLI plugins <code class="docutils literal notranslate"><span class="pre">buildx</span></code> and <code class="docutils literal notranslate"><span class="pre">compose</span></code>.
The <code class="docutils literal notranslate"><span class="pre">docker_image_build</span></code> module uses the <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">buildx</span></code> command under the hood, and the <code class="docutils literal notranslate"><span class="pre">docker_compose_v2</span></code>
and <code class="docutils literal notranslate"><span class="pre">docker_compose_v2_pull</span></code> modules uses the <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">compose</span></code> command. All these modules use the Docker CLI
instead of directly talking to the API. The modules support mostly the same interface as the API based modules,
so the main difference is that instead of some Python requirements, they depend on the Docker CLI tool <code class="docutils literal notranslate"><span class="pre">docker</span></code>.</p>
</section>
<section id="major-changes">
<h3><a class="toc-backref" href="#id356" role="doc-backlink">Major Changes</a><a class="headerlink" href="#major-changes" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The <code class="docutils literal notranslate"><span class="pre">community.docker</span></code> collection now depends on the <code class="docutils literal notranslate"><span class="pre">community.library_inventory_filtering_v1</span></code> collection. This utility collection provides host filtering functionality for inventory plugins. If you use the Ansible community package, both collections are included and you do not have to do anything special. If you install the collection with <code class="docutils literal notranslate"><span class="pre">ansible-galaxy</span> <span class="pre">collection</span> <span class="pre">install</span></code>, it will be installed automatically. If you install the collection by copying the files of the collection to a place where ansible-core can find it, for example by cloning the git repository, you need to make sure that you also have to install the dependency if you are using the inventory plugins (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/698">https://github.com/ansible-collections/community.docker/pull/698</a>).</p></li>
</ul>
</section>
<section id="id81">
<h3><a class="toc-backref" href="#id357" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id81" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The <code class="docutils literal notranslate"><span class="pre">ca_cert</span></code> option available to almost all modules and plugins has been renamed to <code class="docutils literal notranslate"><span class="pre">ca_path</span></code>. The name <code class="docutils literal notranslate"><span class="pre">ca_path</span></code> is also used for similar options in ansible-core and other collections. The old name has been added as an alias and can still be used (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/744">https://github.com/ansible-collections/community.docker/pull/744</a>).</p></li>
<li><p>The <code class="docutils literal notranslate"><span class="pre">docker_stack*</span></code> modules now use the common CLI-based module code added for the <code class="docutils literal notranslate"><span class="pre">docker_image_build</span></code> and <code class="docutils literal notranslate"><span class="pre">docker_compose_v2</span></code> modules. This means that the modules now have various more configuration options with respect to talking to the Docker Daemon, and now also are part of the <code class="docutils literal notranslate"><span class="pre">community.docker.docker</span></code> and <code class="docutils literal notranslate"><span class="pre">docker</span></code> module default groups (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/745">https://github.com/ansible-collections/community.docker/pull/745</a>).</p></li>
<li><p>docker_container - add <code class="docutils literal notranslate"><span class="pre">networks[].mac_address</span></code> option for Docker API 1.44+. Note that Docker API 1.44 no longer uses the global <code class="docutils literal notranslate"><span class="pre">mac_address</span></code> option, this new option is the only way to set the MAC address for a container (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/763">https://github.com/ansible-collections/community.docker/pull/763</a>).</p></li>
<li><p>docker_image - allow to specify labels and <code class="docutils literal notranslate"><span class="pre">/dev/shm</span></code> size when building images (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/726">https://github.com/ansible-collections/community.docker/issues/726</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/727">https://github.com/ansible-collections/community.docker/pull/727</a>).</p></li>
<li><p>docker_image - allow to specify memory size and swap memory size in other units than bytes (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/727">https://github.com/ansible-collections/community.docker/pull/727</a>).</p></li>
<li><p>inventory plugins - add <code class="docutils literal notranslate"><span class="pre">filter</span></code> option which allows to include and exclude hosts based on Jinja2 conditions (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/698">https://github.com/ansible-collections/community.docker/pull/698</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/610">https://github.com/ansible-collections/community.docker/issues/610</a>).</p></li>
</ul>
</section>
<section id="id82">
<h3><a class="toc-backref" href="#id358" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id82" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Use <code class="docutils literal notranslate"><span class="pre">unix:///var/run/docker.sock</span></code> instead of the legacy <code class="docutils literal notranslate"><span class="pre">unix://var/run/docker.sock</span></code> as default for <code class="docutils literal notranslate"><span class="pre">docker_host</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/736">https://github.com/ansible-collections/community.docker/pull/736</a>).</p></li>
<li><p>docker_image - fix archiving idempotency with Docker API 1.44 or later (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/765">https://github.com/ansible-collections/community.docker/pull/765</a>).</p></li>
</ul>
</section>
<section id="id83">
<h3><a class="toc-backref" href="#id359" role="doc-backlink">New Modules</a><a class="headerlink" href="#id83" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_compose_v2 - Manage multi-container Docker applications with Docker Compose CLI plugin</p></li>
<li><p>community.docker.docker_compose_v2_pull - Pull a Docker compose project</p></li>
<li><p>community.docker.docker_image_build - Build Docker images using Docker buildx</p></li>
<li><p>community.docker.docker_image_pull - Pull Docker images from registries</p></li>
<li><p>community.docker.docker_image_push - Push Docker images to registries</p></li>
<li><p>community.docker.docker_image_remove - Remove Docker images</p></li>
<li><p>community.docker.docker_image_tag - Tag Docker images with new names and/or tags</p></li>
</ul>
</section>
</section>
<section id="v3-5-0">
<h2><a class="toc-backref" href="#id360" role="doc-backlink">v3.5.0</a><a class="headerlink" href="#v3-5-0" title="Link to this heading"></a></h2>
<section id="id84">
<h3><a class="toc-backref" href="#id361" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id84" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id85">
<h3><a class="toc-backref" href="#id362" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id85" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - implement better <code class="docutils literal notranslate"><span class="pre">platform</span></code> string comparisons to improve idempotency (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/654">https://github.com/ansible-collections/community.docker/issues/654</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/705">https://github.com/ansible-collections/community.docker/pull/705</a>).</p></li>
<li><p>docker_container - internal refactorings which allow comparisons to use more information like details of the current image or the Docker host config (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/713">https://github.com/ansible-collections/community.docker/pull/713</a>).</p></li>
</ul>
</section>
<section id="id86">
<h3><a class="toc-backref" href="#id363" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id86" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the default <code class="docutils literal notranslate"><span class="pre">ignore</span></code> for the <code class="docutils literal notranslate"><span class="pre">image_name_mismatch</span></code> parameter has been deprecated and will switch to <code class="docutils literal notranslate"><span class="pre">recreate</span></code> in community.docker 4.0.0. A deprecation warning will be printed in situations where the default value is used and where a behavior would change once the default changes (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/703">https://github.com/ansible-collections/community.docker/pull/703</a>).</p></li>
</ul>
</section>
<section id="id87">
<h3><a class="toc-backref" href="#id364" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id87" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>modules and plugins using the Docker SDK for Python - remove <code class="docutils literal notranslate"><span class="pre">ssl_version</span></code> from the parameters passed to Docker SDK for Python 7.0.0+. Explicitly fail with a nicer error message if it was explicitly set in this case (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/715">https://github.com/ansible-collections/community.docker/pull/715</a>).</p></li>
<li><p>modules and plugins using the Docker SDK for Python - remove <code class="docutils literal notranslate"><span class="pre">tls_hostname</span></code> from the parameters passed to Docker SDK for Python 7.0.0+. Explicitly fail with a nicer error message if it was explicitly set in this case (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/721">https://github.com/ansible-collections/community.docker/pull/721</a>).</p></li>
<li><p>vendored Docker SDK for Python - avoid passing on <code class="docutils literal notranslate"><span class="pre">ssl_version</span></code> and <code class="docutils literal notranslate"><span class="pre">tls_hostname</span></code> if they were not provided by the user. Remove dead code. (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/722">https://github.com/ansible-collections/community.docker/pull/722</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-11">
<h2><a class="toc-backref" href="#id365" role="doc-backlink">v3.4.11</a><a class="headerlink" href="#v3-4-11" title="Link to this heading"></a></h2>
<section id="id88">
<h3><a class="toc-backref" href="#id366" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id88" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id89">
<h3><a class="toc-backref" href="#id367" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id89" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_volume - fix crash caused by accessing an empty dictionary. The <code class="docutils literal notranslate"><span class="pre">has_different_config()</span></code> was raising an <code class="docutils literal notranslate"><span class="pre">AttributeError</span></code> because the <code class="docutils literal notranslate"><span class="pre">self.existing_volume[&quot;Labels&quot;]</span></code> dictionary was <code class="docutils literal notranslate"><span class="pre">None</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/702">https://github.com/ansible-collections/community.docker/pull/702</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-10">
<h2><a class="toc-backref" href="#id368" role="doc-backlink">v3.4.10</a><a class="headerlink" href="#v3-4-10" title="Link to this heading"></a></h2>
<section id="id90">
<h3><a class="toc-backref" href="#id369" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id90" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id91">
<h3><a class="toc-backref" href="#id370" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id91" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm - make init and join operations work again with Docker SDK for Python before 4.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/695">https://github.com/ansible-collections/community.docker/issues/695</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/696">https://github.com/ansible-collections/community.docker/pull/696</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-9">
<h2><a class="toc-backref" href="#id371" role="doc-backlink">v3.4.9</a><a class="headerlink" href="#v3-4-9" title="Link to this heading"></a></h2>
<section id="id92">
<h3><a class="toc-backref" href="#id372" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id92" title="Link to this heading"></a></h3>
<p>Maintenance release with updated documentation and vendored Docker SDK for Python code.</p>
</section>
<section id="id93">
<h3><a class="toc-backref" href="#id373" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id93" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>vendored Docker SDK for Python code - cherry-pick changes from the Docker SDK for Python code to align code. These changes should not affect the parts used by the collection’s code (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/694">https://github.com/ansible-collections/community.docker/pull/694</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-8">
<h2><a class="toc-backref" href="#id374" role="doc-backlink">v3.4.8</a><a class="headerlink" href="#v3-4-8" title="Link to this heading"></a></h2>
<section id="id94">
<h3><a class="toc-backref" href="#id375" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id94" title="Link to this heading"></a></h3>
<p>Maintenance release with updated documentation.</p>
<p>From this version on, community.docker is using the new <a class="reference external" href="https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_documenting.html#semantic-markup-within-module-documentation">Ansible semantic markup</a>
in its documentation. If you look at documentation with the ansible-doc CLI tool
from ansible-core before 2.15, please note that it does not render the markup
correctly. You should be still able to read it in most cases, but you need
ansible-core 2.15 or later to see it as it is intended. Alternatively you can
look at <a class="reference external" href="https://docs.ansible.com/ansible/devel/collections/community/docker/">the devel docsite</a>
for the rendered HTML version of the documentation of the latest release.</p>
</section>
<section id="id95">
<h3><a class="toc-backref" href="#id376" role="doc-backlink">Known Issues</a><a class="headerlink" href="#id95" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Ansible markup will show up in raw form on ansible-doc text output for ansible-core before 2.15. If you have trouble deciphering the documentation markup, please upgrade to ansible-core 2.15 (or newer), or read the HTML documentation on <a class="reference external" href="https://docs.ansible.com/ansible/devel/collections/community/docker/">https://docs.ansible.com/ansible/devel/collections/community/docker/</a>.</p></li>
</ul>
</section>
</section>
<section id="v3-4-7">
<h2><a class="toc-backref" href="#id377" role="doc-backlink">v3.4.7</a><a class="headerlink" href="#v3-4-7" title="Link to this heading"></a></h2>
<section id="id96">
<h3><a class="toc-backref" href="#id378" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id96" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id97">
<h3><a class="toc-backref" href="#id379" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id97" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm_info - if <code class="docutils literal notranslate"><span class="pre">service=true</span></code> is used, do not crash when a service without an endpoint spec is encountered (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/636">https://github.com/ansible-collections/community.docker/issues/636</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/637">https://github.com/ansible-collections/community.docker/pull/637</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-6">
<h2><a class="toc-backref" href="#id380" role="doc-backlink">v3.4.6</a><a class="headerlink" href="#v3-4-6" title="Link to this heading"></a></h2>
<section id="id98">
<h3><a class="toc-backref" href="#id381" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id98" title="Link to this heading"></a></h3>
<p>Bugfix release with documentation warnings about using certain functionality when connecting to the Docker daemon with TCP TLS.</p>
</section>
<section id="id99">
<h3><a class="toc-backref" href="#id382" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id99" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>socket_handler module utils - make sure this fully works when Docker SDK for Python is not available (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/620">https://github.com/ansible-collections/community.docker/pull/620</a>).</p></li>
<li><p>vendored Docker SDK for Python code - fix for errors on pipe close in Windows (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/619">https://github.com/ansible-collections/community.docker/pull/619</a>).</p></li>
<li><p>vendored Docker SDK for Python code - respect timeouts on Windows named pipes (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/619">https://github.com/ansible-collections/community.docker/pull/619</a>).</p></li>
<li><p>vendored Docker SDK for Python code - use <code class="docutils literal notranslate"><span class="pre">poll()</span></code> instead of <code class="docutils literal notranslate"><span class="pre">select()</span></code> except on Windows (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/619">https://github.com/ansible-collections/community.docker/pull/619</a>).</p></li>
</ul>
</section>
<section id="id100">
<h3><a class="toc-backref" href="#id383" role="doc-backlink">Known Issues</a><a class="headerlink" href="#id100" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_api connection plugin - does <strong>not work with TCP TLS sockets</strong>! This is caused by the inability to send an <code class="docutils literal notranslate"><span class="pre">close_notify</span></code> TLS alert without closing the connection with Python’s <code class="docutils literal notranslate"><span class="pre">SSLSocket</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/605">https://github.com/ansible-collections/community.docker/issues/605</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/621">https://github.com/ansible-collections/community.docker/pull/621</a>).</p></li>
<li><p>docker_container_exec - does <strong>not work with TCP TLS sockets</strong> when the <code class="docutils literal notranslate"><span class="pre">stdin</span></code> option is used! This is caused by the inability to send an <code class="docutils literal notranslate"><span class="pre">close_notify</span></code> TLS alert without closing the connection with Python’s <code class="docutils literal notranslate"><span class="pre">SSLSocket</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/605">https://github.com/ansible-collections/community.docker/issues/605</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/621">https://github.com/ansible-collections/community.docker/pull/621</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-5">
<h2><a class="toc-backref" href="#id384" role="doc-backlink">v3.4.5</a><a class="headerlink" href="#v3-4-5" title="Link to this heading"></a></h2>
<section id="id101">
<h3><a class="toc-backref" href="#id385" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id101" title="Link to this heading"></a></h3>
<p>Maintenance release which adds compatibility with requests 2.29.0 and 2.30.0 and urllib3 2.0.</p>
</section>
<section id="id102">
<h3><a class="toc-backref" href="#id386" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id102" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Make vendored Docker SDK for Python code compatible with requests 2.29.0 and urllib3 2.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/613">https://github.com/ansible-collections/community.docker/pull/613</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-4">
<h2><a class="toc-backref" href="#id387" role="doc-backlink">v3.4.4</a><a class="headerlink" href="#v3-4-4" title="Link to this heading"></a></h2>
<section id="id103">
<h3><a class="toc-backref" href="#id388" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id103" title="Link to this heading"></a></h3>
<p>Maintenance release with updated EE requirements and updated documentation.</p>
</section>
<section id="id104">
<h3><a class="toc-backref" href="#id389" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id104" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Restrict requests to versions before 2.29.0, and urllib3 to versions before 2.0.0. This is necessary until the vendored code from Docker SDK for Python has been fully adjusted to work with a feature of urllib3 that is used since requests 2.29.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/611">https://github.com/ansible-collections/community.docker/issues/611</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/612">https://github.com/ansible-collections/community.docker/pull/612</a>).</p></li>
</ul>
</section>
<section id="id105">
<h3><a class="toc-backref" href="#id390" role="doc-backlink">Known Issues</a><a class="headerlink" href="#id105" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The modules and plugins using the vendored code from Docker SDK for Python currently do not work with requests 2.29.0 and/or urllib3 2.0.0. The same is currently true for the latest version of Docker SDK for Python itself (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/611">https://github.com/ansible-collections/community.docker/issues/611</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/612">https://github.com/ansible-collections/community.docker/pull/612</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-3">
<h2><a class="toc-backref" href="#id391" role="doc-backlink">v3.4.3</a><a class="headerlink" href="#v3-4-3" title="Link to this heading"></a></h2>
<section id="id106">
<h3><a class="toc-backref" href="#id392" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id106" title="Link to this heading"></a></h3>
<p>Maintenance release with improved documentation.</p>
</section>
</section>
<section id="v3-4-2">
<h2><a class="toc-backref" href="#id393" role="doc-backlink">v3.4.2</a><a class="headerlink" href="#v3-4-2" title="Link to this heading"></a></h2>
<section id="id107">
<h3><a class="toc-backref" href="#id394" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id107" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id108">
<h3><a class="toc-backref" href="#id395" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id108" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_prune - return correct value for <code class="docutils literal notranslate"><span class="pre">changed</span></code>. So far the module always claimed that nothing changed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/593">https://github.com/ansible-collections/community.docker/pull/593</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-1">
<h2><a class="toc-backref" href="#id396" role="doc-backlink">v3.4.1</a><a class="headerlink" href="#v3-4-1" title="Link to this heading"></a></h2>
<section id="id109">
<h3><a class="toc-backref" href="#id397" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id109" title="Link to this heading"></a></h3>
<p>Regular bugfix release.</p>
</section>
<section id="id110">
<h3><a class="toc-backref" href="#id398" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id110" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_api connection plugin, docker_container_exec, docker_container_copy_into - properly close socket to Daemon after executing commands in containers (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/582">https://github.com/ansible-collections/community.docker/pull/582</a>).</p></li>
<li><p>docker_container - fix <code class="docutils literal notranslate"><span class="pre">tmfs_size</span></code> and <code class="docutils literal notranslate"><span class="pre">tmpfs_mode</span></code> not being set (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/580">https://github.com/ansible-collections/community.docker/pull/580</a>).</p></li>
<li><p>various plugins and modules - remove unnecessary imports (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/574">https://github.com/ansible-collections/community.docker/pull/574</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-4-0">
<h2><a class="toc-backref" href="#id399" role="doc-backlink">v3.4.0</a><a class="headerlink" href="#v3-4-0" title="Link to this heading"></a></h2>
<section id="id111">
<h3><a class="toc-backref" href="#id400" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id111" title="Link to this heading"></a></h3>
<p>Regular bugfix and feature release.</p>
</section>
<section id="id112">
<h3><a class="toc-backref" href="#id401" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id112" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_api connection plugin - when copying files to/from a container, stream the file contents instead of first reading them to memory (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/545">https://github.com/ansible-collections/community.docker/pull/545</a>).</p></li>
<li><p>docker_host_info - allow to list all containers with new option <code class="docutils literal notranslate"><span class="pre">containers_all</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/535">https://github.com/ansible-collections/community.docker/issues/535</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/538">https://github.com/ansible-collections/community.docker/pull/538</a>).</p></li>
</ul>
</section>
<section id="id113">
<h3><a class="toc-backref" href="#id402" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id113" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_api connection plugin - fix error handling when 409 Conflict is returned by the Docker daemon in case of a stopped container (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/546">https://github.com/ansible-collections/community.docker/pull/546</a>).</p></li>
<li><p>docker_container_exec - fix error handling when 409 Conflict is returned by the Docker daemon in case of a stopped container (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/546">https://github.com/ansible-collections/community.docker/pull/546</a>).</p></li>
<li><p>docker_plugin - do not crash if plugin is installed in check mode (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/552">https://github.com/ansible-collections/community.docker/issues/552</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/553">https://github.com/ansible-collections/community.docker/pull/553</a>).</p></li>
<li><p>most modules - fix handling of <code class="docutils literal notranslate"><span class="pre">DOCKER_TIMEOUT</span></code> environment variable, and improve handling of other fallback environment variables (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/551">https://github.com/ansible-collections/community.docker/issues/551</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/554">https://github.com/ansible-collections/community.docker/pull/554</a>).</p></li>
</ul>
</section>
<section id="id114">
<h3><a class="toc-backref" href="#id403" role="doc-backlink">New Modules</a><a class="headerlink" href="#id114" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_container_copy_into - Copy a file into a Docker container</p></li>
</ul>
</section>
</section>
<section id="v3-3-2">
<h2><a class="toc-backref" href="#id404" role="doc-backlink">v3.3.2</a><a class="headerlink" href="#v3-3-2" title="Link to this heading"></a></h2>
<section id="id115">
<h3><a class="toc-backref" href="#id405" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id115" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id116">
<h3><a class="toc-backref" href="#id406" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id116" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - when <code class="docutils literal notranslate"><span class="pre">detach=false</span></code>, wait indefinitely and not at most one minute. This was the behavior with Docker SDK for Python, and was accidentally changed in 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/526">https://github.com/ansible-collections/community.docker/issues/526</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/527">https://github.com/ansible-collections/community.docker/pull/527</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-3-1">
<h2><a class="toc-backref" href="#id407" role="doc-backlink">v3.3.1</a><a class="headerlink" href="#v3-3-1" title="Link to this heading"></a></h2>
<section id="id117">
<h3><a class="toc-backref" href="#id408" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id117" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id118">
<h3><a class="toc-backref" href="#id409" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id118" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>current_container_facts - make container detection work better in more cases (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/522">https://github.com/ansible-collections/community.docker/pull/522</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-3-0">
<h2><a class="toc-backref" href="#id410" role="doc-backlink">v3.3.0</a><a class="headerlink" href="#v3-3-0" title="Link to this heading"></a></h2>
<section id="id119">
<h3><a class="toc-backref" href="#id411" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id119" title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<section id="id120">
<h3><a class="toc-backref" href="#id412" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id120" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>current_container_facts - make work with current Docker version, also support Podman (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/510">https://github.com/ansible-collections/community.docker/pull/510</a>).</p></li>
<li><p>docker_image - when using <code class="docutils literal notranslate"><span class="pre">archive_path</span></code>, detect whether changes are necessary based on the image ID (hash). If the existing tar archive matches the source, do nothing. Previously, each task execution re-created the archive (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/500">https://github.com/ansible-collections/community.docker/pull/500</a>).</p></li>
</ul>
</section>
<section id="id121">
<h3><a class="toc-backref" href="#id413" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id121" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container_exec - fix <code class="docutils literal notranslate"><span class="pre">chdir</span></code> option which was ignored since community.docker 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/517">https://github.com/ansible-collections/community.docker/issues/517</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/518">https://github.com/ansible-collections/community.docker/pull/518</a>).</p></li>
<li><p>vendored latest Docker SDK for Python bugfix (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/513">https://github.com/ansible-collections/community.docker/pull/513</a>, <a class="reference external" href="https://github.com/docker/docker-py/issues/3045">https://github.com/docker/docker-py/issues/3045</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-2-2">
<h2><a class="toc-backref" href="#id414" role="doc-backlink">v3.2.2</a><a class="headerlink" href="#v3-2-2" title="Link to this heading"></a></h2>
<section id="id122">
<h3><a class="toc-backref" href="#id415" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id122" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id123">
<h3><a class="toc-backref" href="#id416" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id123" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">kill_signal</span></code> option erroneously did not accept strings anymore since 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/505">https://github.com/ansible-collections/community.docker/issues/505</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/506">https://github.com/ansible-collections/community.docker/pull/506</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-2-1">
<h2><a class="toc-backref" href="#id417" role="doc-backlink">v3.2.1</a><a class="headerlink" href="#v3-2-1" title="Link to this heading"></a></h2>
<section id="id124">
<h3><a class="toc-backref" href="#id418" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id124" title="Link to this heading"></a></h3>
<p>Maintenance release with improved documentation.</p>
</section>
</section>
<section id="v3-2-0">
<h2><a class="toc-backref" href="#id419" role="doc-backlink">v3.2.0</a><a class="headerlink" href="#v3-2-0" title="Link to this heading"></a></h2>
<section id="id125">
<h3><a class="toc-backref" href="#id420" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id125" title="Link to this heading"></a></h3>
<p>Feature and deprecation release.</p>
</section>
<section id="id126">
<h3><a class="toc-backref" href="#id421" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id126" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - added <code class="docutils literal notranslate"><span class="pre">image_name_mismatch</span></code> option which allows to control the behavior if the container uses the image specified, but the container’s configuration uses a different name for the image than the one provided to the module (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/485">https://github.com/ansible-collections/community.docker/issues/485</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/488">https://github.com/ansible-collections/community.docker/pull/488</a>).</p></li>
</ul>
</section>
<section id="id127">
<h3><a class="toc-backref" href="#id422" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id127" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">ignore_image</span></code> option is deprecated and will be removed in community.docker 4.0.0. Use <code class="docutils literal notranslate"><span class="pre">image:</span> <span class="pre">ignore</span></code> in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/487">https://github.com/ansible-collections/community.docker/pull/487</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">purge_networks</span></code> option is deprecated and will be removed in community.docker 4.0.0. Use <code class="docutils literal notranslate"><span class="pre">networks:</span> <span class="pre">strict</span></code> in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code> instead, and make sure to provide <code class="docutils literal notranslate"><span class="pre">networks</span></code>, with value <code class="docutils literal notranslate"><span class="pre">[]</span></code> if all networks should be removed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/487">https://github.com/ansible-collections/community.docker/pull/487</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-1-0">
<h2><a class="toc-backref" href="#id423" role="doc-backlink">v3.1.0</a><a class="headerlink" href="#v3-1-0" title="Link to this heading"></a></h2>
<section id="id128">
<h3><a class="toc-backref" href="#id424" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id128" title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<section id="id129">
<h3><a class="toc-backref" href="#id425" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id129" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The collection repository conforms to the <a class="reference external" href="https://reuse.software/spec/">REUSE specification</a> except for the changelog fragments (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/462">https://github.com/ansible-collections/community.docker/pull/462</a>).</p></li>
<li><p>docker_swarm - allows usage of the <code class="docutils literal notranslate"><span class="pre">data_path_port</span></code> parameter when initializing a swarm (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/296">https://github.com/ansible-collections/community.docker/issues/296</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-0-2">
<h2><a class="toc-backref" href="#id426" role="doc-backlink">v3.0.2</a><a class="headerlink" href="#v3-0-2" title="Link to this heading"></a></h2>
<section id="id130">
<h3><a class="toc-backref" href="#id427" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id130" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id131">
<h3><a class="toc-backref" href="#id428" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id131" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_image - fix build argument handling (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/455">https://github.com/ansible-collections/community.docker/issues/455</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/456">https://github.com/ansible-collections/community.docker/pull/456</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-0-1">
<h2><a class="toc-backref" href="#id429" role="doc-backlink">v3.0.1</a><a class="headerlink" href="#v3-0-1" title="Link to this heading"></a></h2>
<section id="id132">
<h3><a class="toc-backref" href="#id430" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id132" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id133">
<h3><a class="toc-backref" href="#id431" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id133" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - fix handling of <code class="docutils literal notranslate"><span class="pre">env_file</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/451">https://github.com/ansible-collections/community.docker/issues/451</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/452">https://github.com/ansible-collections/community.docker/pull/452</a>).</p></li>
</ul>
</section>
</section>
<section id="v3-0-0">
<h2><a class="toc-backref" href="#id432" role="doc-backlink">v3.0.0</a><a class="headerlink" href="#v3-0-0" title="Link to this heading"></a></h2>
<section id="id134">
<h3><a class="toc-backref" href="#id433" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id134" title="Link to this heading"></a></h3>
<p>The 3.0.0 release features a rewrite of the <code class="docutils literal notranslate"><span class="pre">docker_container</span></code> module, and many modules and plugins no longer depend on the Docker SDK for Python.</p>
</section>
<section id="id135">
<h3><a class="toc-backref" href="#id434" role="doc-backlink">Major Changes</a><a class="headerlink" href="#id135" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>The collection now contains vendored code from the Docker SDK for Python to talk to the Docker daemon. Modules and plugins using this code no longer need the Docker SDK for Python installed on the machine the module or plugin is running on (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/398">https://github.com/ansible-collections/community.docker/pull/398</a>).</p></li>
<li><p>docker_api connection plugin - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/414">https://github.com/ansible-collections/community.docker/pull/414</a>).</p></li>
<li><p>docker_container - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container - the module was completely rewritten from scratch (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container_exec - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/401">https://github.com/ansible-collections/community.docker/pull/401</a>).</p></li>
<li><p>docker_container_info - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/402">https://github.com/ansible-collections/community.docker/pull/402</a>).</p></li>
<li><p>docker_containers inventory plugin - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/413">https://github.com/ansible-collections/community.docker/pull/413</a>).</p></li>
<li><p>docker_host_info - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/403">https://github.com/ansible-collections/community.docker/pull/403</a>).</p></li>
<li><p>docker_image - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/404">https://github.com/ansible-collections/community.docker/pull/404</a>).</p></li>
<li><p>docker_image_info - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/405">https://github.com/ansible-collections/community.docker/pull/405</a>).</p></li>
<li><p>docker_image_load - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/406">https://github.com/ansible-collections/community.docker/pull/406</a>).</p></li>
<li><p>docker_login - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/407">https://github.com/ansible-collections/community.docker/pull/407</a>).</p></li>
<li><p>docker_network - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/408">https://github.com/ansible-collections/community.docker/pull/408</a>).</p></li>
<li><p>docker_network_info - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/409">https://github.com/ansible-collections/community.docker/pull/409</a>).</p></li>
<li><p>docker_plugin - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/429">https://github.com/ansible-collections/community.docker/pull/429</a>).</p></li>
<li><p>docker_prune - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/410">https://github.com/ansible-collections/community.docker/pull/410</a>).</p></li>
<li><p>docker_volume - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/411">https://github.com/ansible-collections/community.docker/pull/411</a>).</p></li>
<li><p>docker_volume_info - no longer uses the Docker SDK for Python. It requires <code class="docutils literal notranslate"><span class="pre">requests</span></code> to be installed, and depending on the features used has some more requirements. If the Docker SDK for Python is installed, these requirements are likely met (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/412">https://github.com/ansible-collections/community.docker/pull/412</a>).</p></li>
</ul>
</section>
<section id="id136">
<h3><a class="toc-backref" href="#id435" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id136" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>All software licenses are now in the <code class="docutils literal notranslate"><span class="pre">LICENSES/</span></code> directory of the collection root. Moreover, <code class="docutils literal notranslate"><span class="pre">SPDX-License-Identifier:</span></code> is used to declare the applicable license for every file that is not automatically generated (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/430">https://github.com/ansible-collections/community.docker/pull/430</a>).</p></li>
<li><p>Remove vendored copy of <code class="docutils literal notranslate"><span class="pre">distutils.version</span></code> in favor of vendored copy included with ansible-core 2.12+. For ansible-core 2.11, uses <code class="docutils literal notranslate"><span class="pre">distutils.version</span></code> for Python &lt; 3.12. There is no support for ansible-core 2.11 with Python 3.12+ (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/271">https://github.com/ansible-collections/community.docker/pull/271</a>).</p></li>
<li><p>docker_container - add a new parameter <code class="docutils literal notranslate"><span class="pre">image_comparison</span></code> to control the behavior for which image will be used for idempotency checks (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/421">https://github.com/ansible-collections/community.docker/issues/421</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/428">https://github.com/ansible-collections/community.docker/pull/428</a>).</p></li>
<li><p>docker_container - add support for <code class="docutils literal notranslate"><span class="pre">cgroupns_mode</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/338">https://github.com/ansible-collections/community.docker/issues/338</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/427">https://github.com/ansible-collections/community.docker/pull/427</a>).</p></li>
<li><p>docker_container - allow to specify <code class="docutils literal notranslate"><span class="pre">platform</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/123">https://github.com/ansible-collections/community.docker/issues/123</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/426">https://github.com/ansible-collections/community.docker/pull/426</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - improve default TLS version selection for Python 3.6 and newer. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - simplify use of helper function that was removed in Docker SDK for Python to find executables (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/438">https://github.com/ansible-collections/community.docker/pull/438</a>).</p></li>
<li><p>socker_handler and socket_helper module utils - improve Python forward compatibility, create helper functions for file blocking/unblocking (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/415">https://github.com/ansible-collections/community.docker/pull/415</a>).</p></li>
</ul>
</section>
<section id="id137">
<h3><a class="toc-backref" href="#id436" role="doc-backlink">Breaking Changes / Porting Guide</a><a class="headerlink" href="#id137" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>This collection does not work with ansible-core 2.11 on Python 3.12+. Please either upgrade to ansible-core 2.12+, or use Python 3.11 or earlier (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/271">https://github.com/ansible-collections/community.docker/pull/271</a>).</p></li>
<li><p>docker_container - <code class="docutils literal notranslate"><span class="pre">exposed_ports</span></code> is no longer ignored in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code>. Before, its value was assumed to be identical with the value of <code class="docutils literal notranslate"><span class="pre">published_ports</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container - <code class="docutils literal notranslate"><span class="pre">log_options</span></code> can no longer be specified when <code class="docutils literal notranslate"><span class="pre">log_driver</span></code> is not specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container - <code class="docutils literal notranslate"><span class="pre">publish_all_ports</span></code> is no longer ignored in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container - <code class="docutils literal notranslate"><span class="pre">restart_retries</span></code> can no longer be specified when <code class="docutils literal notranslate"><span class="pre">restart_policy</span></code> is not specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>docker_container - <code class="docutils literal notranslate"><span class="pre">stop_timeout</span></code> is no longer ignored for idempotency if told to be not ignored in <code class="docutils literal notranslate"><span class="pre">comparisons</span></code>. So far it defaulted to <code class="docutils literal notranslate"><span class="pre">ignore</span></code> there, and setting it to <code class="docutils literal notranslate"><span class="pre">strict</span></code> had no effect (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/422">https://github.com/ansible-collections/community.docker/pull/422</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - when connecting by SSH and not using <code class="docutils literal notranslate"><span class="pre">use_ssh_client=true</span></code>, reject unknown host keys instead of accepting them. This is only a breaking change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
</ul>
</section>
<section id="id138">
<h3><a class="toc-backref" href="#id437" role="doc-backlink">Removed Features (previously deprecated)</a><a class="headerlink" href="#id138" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Execution Environments built with community.docker no longer include docker-compose &lt; 2.0.0. If you need to use it with the <code class="docutils literal notranslate"><span class="pre">docker_compose</span></code> module, please install that requirement manually (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/400">https://github.com/ansible-collections/community.docker/pull/400</a>).</p></li>
<li><p>Support for Ansible 2.9 and ansible-base 2.10 has been removed. If you need support for Ansible 2.9 or ansible-base 2.10, please use community.docker 2.x.y (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/400">https://github.com/ansible-collections/community.docker/pull/400</a>).</p></li>
<li><p>Support for Docker API versions 1.20 to 1.24 has been removed. If you need support for these API versions, please use community.docker 2.x.y (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/400">https://github.com/ansible-collections/community.docker/pull/400</a>).</p></li>
<li><p>Support for Python 2.6 has been removed. If you need support for Python 2.6, please use community.docker 2.x.y (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/400">https://github.com/ansible-collections/community.docker/pull/400</a>).</p></li>
<li><p>Various modules - the default of <code class="docutils literal notranslate"><span class="pre">tls_hostname</span></code> (<code class="docutils literal notranslate"><span class="pre">localhost</span></code>) has been removed. If you want to continue using <code class="docutils literal notranslate"><span class="pre">localhost</span></code>, you need to specify it explicitly (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/363">https://github.com/ansible-collections/community.docker/pull/363</a>).</p></li>
<li><p>docker_container - the <code class="docutils literal notranslate"><span class="pre">all</span></code> value is no longer allowed in <code class="docutils literal notranslate"><span class="pre">published_ports</span></code>. Use <code class="docutils literal notranslate"><span class="pre">publish_all_ports=true</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/399">https://github.com/ansible-collections/community.docker/pull/399</a>).</p></li>
<li><p>docker_container - the default of <code class="docutils literal notranslate"><span class="pre">command_handling</span></code> was changed from <code class="docutils literal notranslate"><span class="pre">compatibility</span></code> to <code class="docutils literal notranslate"><span class="pre">correct</span></code>. Older versions were warning for every invocation of the module when this would result in a change of behavior (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/399">https://github.com/ansible-collections/community.docker/pull/399</a>).</p></li>
<li><p>docker_stack - the return values <code class="docutils literal notranslate"><span class="pre">out</span></code> and <code class="docutils literal notranslate"><span class="pre">err</span></code> have been removed. Use <code class="docutils literal notranslate"><span class="pre">stdout</span></code> and <code class="docutils literal notranslate"><span class="pre">stderr</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/363">https://github.com/ansible-collections/community.docker/pull/363</a>).</p></li>
</ul>
</section>
<section id="id139">
<h3><a class="toc-backref" href="#id438" role="doc-backlink">Security Fixes</a><a class="headerlink" href="#id139" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>modules and plugins communicating directly with the Docker daemon - when connecting by SSH and not using <code class="docutils literal notranslate"><span class="pre">use_ssh_client=true</span></code>, reject unknown host keys instead of accepting them. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
</ul>
</section>
<section id="id140">
<h3><a class="toc-backref" href="#id439" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id140" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_image - when composing the build context, trim trailing whitespace from <code class="docutils literal notranslate"><span class="pre">.dockerignore</span></code> entries. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
<li><p>docker_plugin - fix crash when handling plugin options (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/446">https://github.com/ansible-collections/community.docker/issues/446</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/447">https://github.com/ansible-collections/community.docker/pull/447</a>).</p></li>
<li><p>docker_stack - fix broken string formatting when reporting error in case <code class="docutils literal notranslate"><span class="pre">compose</span></code> was containing invalid values (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/448">https://github.com/ansible-collections/community.docker/pull/448</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - do not create a subshell for SSH connections when using <code class="docutils literal notranslate"><span class="pre">use_ssh_client=true</span></code>. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - fix <code class="docutils literal notranslate"><span class="pre">ProxyCommand</span></code> handling for SSH connections when not using <code class="docutils literal notranslate"><span class="pre">use_ssh_client=true</span></code>. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - fix parsing of IPv6 addresses with a port in <code class="docutils literal notranslate"><span class="pre">docker_host</span></code>. This is only a change relative to older community.docker 3.0.0 pre-releases or with respect to Docker SDK for Python &lt; 6.0.0. Docker SDK for Python 6.0.0 will also include this change (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/434">https://github.com/ansible-collections/community.docker/pull/434</a>).</p></li>
<li><p>modules and plugins communicating directly with the Docker daemon - prevent crash when TLS is used (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/432">https://github.com/ansible-collections/community.docker/pull/432</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-7-0">
<h2><a class="toc-backref" href="#id440" role="doc-backlink">v2.7.0</a><a class="headerlink" href="#v2-7-0" title="Link to this heading"></a></h2>
<section id="id141">
<h3><a class="toc-backref" href="#id441" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id141" title="Link to this heading"></a></h3>
<p>Bugfix and deprecation release. The next 2.x.y releases will only be bugfix releases, the next expect minor/major release will be 3.0.0 with some major changes.</p>
</section>
<section id="id142">
<h3><a class="toc-backref" href="#id442" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id142" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Move common utility functions from the <code class="docutils literal notranslate"><span class="pre">common</span></code> module_util to a new module_util called <code class="docutils literal notranslate"><span class="pre">util</span></code>. This should not have any user-visible effect (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/390">https://github.com/ansible-collections/community.docker/pull/390</a>).</p></li>
</ul>
</section>
<section id="id143">
<h3><a class="toc-backref" href="#id443" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id143" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Support for Docker API version 1.20 to 1.24 has been deprecated and will be removed in community.docker 3.0.0. The first Docker version supporting API version 1.25 was Docker 1.13, released in January 2017. This affects the modules <code class="docutils literal notranslate"><span class="pre">docker_container</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_container_exec</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_container_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_compose</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_login</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_image</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_image_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_image_load</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_host_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_network</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_network_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_node_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_swarm_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_swarm_service</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_swarm_service_info</span></code>, <code class="docutils literal notranslate"><span class="pre">docker_volume_info</span></code>, and <code class="docutils literal notranslate"><span class="pre">docker_volume</span></code>, whose minimally supported API version is between 1.20 and 1.24 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/396">https://github.com/ansible-collections/community.docker/pull/396</a>).</p></li>
<li><p>Support for Python 2.6 is deprecated and will be removed in the next major release (community.docker 3.0.0). Some modules might still work with Python 2.6, but we will no longer try to ensure compatibility (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/388">https://github.com/ansible-collections/community.docker/pull/388</a>).</p></li>
</ul>
</section>
<section id="id144">
<h3><a class="toc-backref" href="#id444" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id144" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Docker SDK for Python based modules and plugins - if the API version is specified as an option, use that one to validate API version requirements of module/plugin options instead of the latest API version supported by the Docker daemon. This also avoids one unnecessary API call per module/plugin (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/389">https://github.com/ansible-collections/community.docker/pull/389</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-6-0">
<h2><a class="toc-backref" href="#id445" role="doc-backlink">v2.6.0</a><a class="headerlink" href="#v2-6-0" title="Link to this heading"></a></h2>
<section id="id145">
<h3><a class="toc-backref" href="#id446" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id145" title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<section id="id146">
<h3><a class="toc-backref" href="#id447" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id146" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - added <code class="docutils literal notranslate"><span class="pre">image_label_mismatch</span></code> parameter (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/314">https://github.com/ansible-collections/community.docker/issues/314</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/370">https://github.com/ansible-collections/community.docker/pull/370</a>).</p></li>
</ul>
</section>
<section id="id147">
<h3><a class="toc-backref" href="#id448" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id147" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.docker 3.0.0). Some modules might still work with these versions afterwards, but we will no longer keep compatibility code that was needed to support them (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/361">https://github.com/ansible-collections/community.docker/pull/361</a>).</p></li>
<li><p>The dependency on docker-compose for Execution Environments is deprecated and will be removed in community.docker 3.0.0. The <a class="reference external" href="https://pypi.org/project/docker-compose/">Python docker-compose library</a> is unmaintained and can cause dependency issues. You can manually still install it in an Execution Environment when needed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/373">https://github.com/ansible-collections/community.docker/pull/373</a>).</p></li>
<li><p>Various modules - the default of <code class="docutils literal notranslate"><span class="pre">tls_hostname</span></code> that was supposed to be removed in community.docker 2.0.0 will now be removed in version 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/362">https://github.com/ansible-collections/community.docker/pull/362</a>).</p></li>
<li><p>docker_stack - the return values <code class="docutils literal notranslate"><span class="pre">out</span></code> and <code class="docutils literal notranslate"><span class="pre">err</span></code> that were supposed to be removed in community.docker 2.0.0 will now be removed in version 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/362">https://github.com/ansible-collections/community.docker/pull/362</a>).</p></li>
</ul>
</section>
<section id="id148">
<h3><a class="toc-backref" href="#id449" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id148" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - fail with a meaningful message instead of crashing if a port is specified with more than three colon-separated parts (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/367">https://github.com/ansible-collections/community.docker/pull/367</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/365">https://github.com/ansible-collections/community.docker/issues/365</a>).</p></li>
<li><p>docker_container - remove unused code that will cause problems with Python 3.13 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/354">https://github.com/ansible-collections/community.docker/pull/354</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-5-1">
<h2><a class="toc-backref" href="#id450" role="doc-backlink">v2.5.1</a><a class="headerlink" href="#v2-5-1" title="Link to this heading"></a></h2>
<section id="id149">
<h3><a class="toc-backref" href="#id451" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id149" title="Link to this heading"></a></h3>
<p>Maintenance release.</p>
</section>
<section id="id150">
<h3><a class="toc-backref" href="#id452" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id150" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Include <code class="docutils literal notranslate"><span class="pre">PSF-license.txt</span></code> file for <code class="docutils literal notranslate"><span class="pre">plugins/module_utils/_version.py</span></code>.</p></li>
</ul>
</section>
</section>
<section id="v2-5-0">
<h2><a class="toc-backref" href="#id453" role="doc-backlink">v2.5.0</a><a class="headerlink" href="#v2-5-0" title="Link to this heading"></a></h2>
<section id="id151">
<h3><a class="toc-backref" href="#id454" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id151" title="Link to this heading"></a></h3>
<p>Regular feature release.</p>
</section>
<section id="id152">
<h3><a class="toc-backref" href="#id455" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id152" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_config - add support for <code class="docutils literal notranslate"><span class="pre">template_driver</span></code> with one option <code class="docutils literal notranslate"><span class="pre">golang</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/332">https://github.com/ansible-collections/community.docker/issues/332</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/345">https://github.com/ansible-collections/community.docker/pull/345</a>).</p></li>
<li><p>docker_swarm - adds <code class="docutils literal notranslate"><span class="pre">data_path_addr</span></code> parameter during swarm initialization or when joining (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/339">https://github.com/ansible-collections/community.docker/issues/339</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-4-0">
<h2><a class="toc-backref" href="#id456" role="doc-backlink">v2.4.0</a><a class="headerlink" href="#v2-4-0" title="Link to this heading"></a></h2>
<section id="id153">
<h3><a class="toc-backref" href="#id457" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id153" title="Link to this heading"></a></h3>
<p>Regular feature and bugfix release.</p>
</section>
<section id="id154">
<h3><a class="toc-backref" href="#id458" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id154" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Prepare collection for inclusion in an Execution Environment by declaring its dependencies. The <code class="docutils literal notranslate"><span class="pre">docker_stack*</span></code> modules are not supported (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/336">https://github.com/ansible-collections/community.docker/pull/336</a>).</p></li>
<li><p>current_container_facts - add detection for GitHub Actions (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/336">https://github.com/ansible-collections/community.docker/pull/336</a>).</p></li>
<li><p>docker_container - support returning Docker container log output when using Docker’s <code class="docutils literal notranslate"><span class="pre">local</span></code> logging driver, an optimized local logging driver introduced in Docker 18.09 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/337">https://github.com/ansible-collections/community.docker/pull/337</a>).</p></li>
</ul>
</section>
<section id="id155">
<h3><a class="toc-backref" href="#id459" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id155" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker connection plugin - make sure that <code class="docutils literal notranslate"><span class="pre">docker_extra_args</span></code> is used for querying the Docker version. Also ensures that the Docker version is only queried when needed. This is currently the case if a remote user is specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/325">https://github.com/ansible-collections/community.docker/issues/325</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/327">https://github.com/ansible-collections/community.docker/pull/327</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-3-0">
<h2><a class="toc-backref" href="#id460" role="doc-backlink">v2.3.0</a><a class="headerlink" href="#v2-3-0" title="Link to this heading"></a></h2>
<section id="id156">
<h3><a class="toc-backref" href="#id461" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id156" title="Link to this heading"></a></h3>
<p>Regular feature and bugfix release.</p>
</section>
<section id="id157">
<h3><a class="toc-backref" href="#id462" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id157" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker connection plugin - implement connection reset by clearing internal container user cache (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/312">https://github.com/ansible-collections/community.docker/pull/312</a>).</p></li>
<li><p>docker connection plugin - simplify <code class="docutils literal notranslate"><span class="pre">actual_user</span></code> handling code (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/311">https://github.com/ansible-collections/community.docker/pull/311</a>).</p></li>
<li><p>docker connection plugin - the plugin supports new ways to define the timeout. These are the <code class="docutils literal notranslate"><span class="pre">ANSIBLE_DOCKER_TIMEOUT</span></code> environment variable, the <code class="docutils literal notranslate"><span class="pre">timeout</span></code> setting in the <code class="docutils literal notranslate"><span class="pre">docker_connection</span></code> section of <code class="docutils literal notranslate"><span class="pre">ansible.cfg</span></code>, and the <code class="docutils literal notranslate"><span class="pre">ansible_docker_timeout</span></code> variable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/297">https://github.com/ansible-collections/community.docker/pull/297</a>).</p></li>
<li><p>docker_api connection plugin - implement connection reset by clearing internal container user/group ID cache (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/312">https://github.com/ansible-collections/community.docker/pull/312</a>).</p></li>
<li><p>docker_api connection plugin - the plugin supports new ways to define the timeout. These are the <code class="docutils literal notranslate"><span class="pre">ANSIBLE_DOCKER_TIMEOUT</span></code> environment variable, the <code class="docutils literal notranslate"><span class="pre">timeout</span></code> setting in the <code class="docutils literal notranslate"><span class="pre">docker_connection</span></code> section of <code class="docutils literal notranslate"><span class="pre">ansible.cfg</span></code>, and the <code class="docutils literal notranslate"><span class="pre">ansible_docker_timeout</span></code> variable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/308">https://github.com/ansible-collections/community.docker/pull/308</a>).</p></li>
</ul>
</section>
<section id="id158">
<h3><a class="toc-backref" href="#id463" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id158" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker connection plugin - fix option handling to be compatible with ansible-core 2.13 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/297">https://github.com/ansible-collections/community.docker/pull/297</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/307">https://github.com/ansible-collections/community.docker/issues/307</a>).</p></li>
<li><p>docker_api connection plugin - fix option handling to be compatible with ansible-core 2.13 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/308">https://github.com/ansible-collections/community.docker/pull/308</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-2-1">
<h2><a class="toc-backref" href="#id464" role="doc-backlink">v2.2.1</a><a class="headerlink" href="#v2-2-1" title="Link to this heading"></a></h2>
<section id="id159">
<h3><a class="toc-backref" href="#id465" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id159" title="Link to this heading"></a></h3>
<p>Regular bugfix release.</p>
</section>
<section id="id160">
<h3><a class="toc-backref" href="#id466" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id160" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - fix Python 3 type error when extracting warnings or errors from docker-compose’s output (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/305">https://github.com/ansible-collections/community.docker/pull/305</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-2-0">
<h2><a class="toc-backref" href="#id467" role="doc-backlink">v2.2.0</a><a class="headerlink" href="#v2-2-0" title="Link to this heading"></a></h2>
<section id="id161">
<h3><a class="toc-backref" href="#id468" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id161" title="Link to this heading"></a></h3>
<p>Regular feature and bugfix release.</p>
</section>
<section id="id162">
<h3><a class="toc-backref" href="#id469" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id162" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_config - add support for rolling update, set <code class="docutils literal notranslate"><span class="pre">rolling_versions</span></code> to <code class="docutils literal notranslate"><span class="pre">true</span></code> to enable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/295">https://github.com/ansible-collections/community.docker/pull/295</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/109">https://github.com/ansible-collections/community.docker/issues/109</a>).</p></li>
<li><p>docker_secret - add support for rolling update, set <code class="docutils literal notranslate"><span class="pre">rolling_versions</span></code> to <code class="docutils literal notranslate"><span class="pre">true</span></code> to enable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/293">https://github.com/ansible-collections/community.docker/pull/293</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/21">https://github.com/ansible-collections/community.docker/issues/21</a>).</p></li>
<li><p>docker_swarm_service - add support for setting capabilities with the <code class="docutils literal notranslate"><span class="pre">cap_add</span></code> and <code class="docutils literal notranslate"><span class="pre">cap_drop</span></code> parameters. Usage is the same as with the <code class="docutils literal notranslate"><span class="pre">capabilities</span></code> and <code class="docutils literal notranslate"><span class="pre">cap_drop</span></code> parameters for <code class="docutils literal notranslate"><span class="pre">docker_container</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/294">https://github.com/ansible-collections/community.docker/pull/294</a>).</p></li>
</ul>
</section>
<section id="id163">
<h3><a class="toc-backref" href="#id470" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id163" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container, docker_image - adjust image finding code to peculiarities of <code class="docutils literal notranslate"><span class="pre">podman-docker</span></code>’s API emulation when Docker short names like <code class="docutils literal notranslate"><span class="pre">redis</span></code> are used (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/292">https://github.com/ansible-collections/community.docker/issues/292</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-1-1">
<h2><a class="toc-backref" href="#id471" role="doc-backlink">v2.1.1</a><a class="headerlink" href="#v2-1-1" title="Link to this heading"></a></h2>
<section id="id164">
<h3><a class="toc-backref" href="#id472" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id164" title="Link to this heading"></a></h3>
<p>Emergency release to amend breaking change in previous release.</p>
</section>
<section id="id165">
<h3><a class="toc-backref" href="#id473" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id165" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Fix unintended breaking change caused by <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/258">an earlier fix</a> by vendoring the deprecated Python standard library <code class="docutils literal notranslate"><span class="pre">distutils.version</span></code> until this collection stops supporting Ansible 2.9 and ansible-base 2.10 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/267">https://github.com/ansible-collections/community.docker/issues/267</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/269">https://github.com/ansible-collections/community.docker/pull/269</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-1-0">
<h2><a class="toc-backref" href="#id474" role="doc-backlink">v2.1.0</a><a class="headerlink" href="#v2-1-0" title="Link to this heading"></a></h2>
<section id="id166">
<h3><a class="toc-backref" href="#id475" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id166" title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<section id="id167">
<h3><a class="toc-backref" href="#id476" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id167" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container_exec - add <code class="docutils literal notranslate"><span class="pre">detach</span></code> parameter (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/250">https://github.com/ansible-collections/community.docker/issues/250</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/255">https://github.com/ansible-collections/community.docker/pull/255</a>).</p></li>
<li><p>docker_container_exec - add <code class="docutils literal notranslate"><span class="pre">env</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/248">https://github.com/ansible-collections/community.docker/issues/248</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/254">https://github.com/ansible-collections/community.docker/pull/254</a>).</p></li>
</ul>
</section>
<section id="id168">
<h3><a class="toc-backref" href="#id477" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id168" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Various modules and plugins - use vendored version of <code class="docutils literal notranslate"><span class="pre">distutils.version</span></code> included in ansible-core 2.12 if available. This avoids breakage when <code class="docutils literal notranslate"><span class="pre">distutils</span></code> is removed from the standard library of Python 3.12. Note that ansible-core 2.11, ansible-base 2.10 and Ansible 2.9 are right now not compatible with Python 3.12, hence this fix does not target these ansible-core/-base/2.9 versions (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/258">https://github.com/ansible-collections/community.docker/pull/258</a>).</p></li>
<li><p>docker connection plugin - replace deprecated <code class="docutils literal notranslate"><span class="pre">distutils.spawn.find_executable</span></code> with Ansible’s <code class="docutils literal notranslate"><span class="pre">get_bin_path</span></code> to find the <code class="docutils literal notranslate"><span class="pre">docker</span></code> executable (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/257">https://github.com/ansible-collections/community.docker/pull/257</a>).</p></li>
<li><p>docker_container_exec - disallow using the <code class="docutils literal notranslate"><span class="pre">chdir</span></code> option for Docker API before 1.35 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/253">https://github.com/ansible-collections/community.docker/pull/253</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-0-2">
<h2><a class="toc-backref" href="#id478" role="doc-backlink">v2.0.2</a><a class="headerlink" href="#v2-0-2" title="Link to this heading"></a></h2>
<section id="id169">
<h3><a class="toc-backref" href="#id479" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id169" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id170">
<h3><a class="toc-backref" href="#id480" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id170" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_api connection plugin - avoid passing an unnecessary argument to a Docker SDK for Python call that is only supported by version 3.0.0 or later (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/243">https://github.com/ansible-collections/community.docker/pull/243</a>).</p></li>
<li><p>docker_container_exec - <code class="docutils literal notranslate"><span class="pre">chdir</span></code> is only supported since Docker SDK for Python 3.0.0. Make sure that this option can only use when 3.0.0 or later is installed, and prevent passing this parameter on when <code class="docutils literal notranslate"><span class="pre">chdir</span></code> is not provided to this module (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/243">https://github.com/ansible-collections/community.docker/pull/243</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/242">https://github.com/ansible-collections/community.docker/issues/242</a>).</p></li>
<li><p>nsenter connection plugin - ensure the <code class="docutils literal notranslate"><span class="pre">nsenter_pid</span></code> option is retrieved in <code class="docutils literal notranslate"><span class="pre">_connect</span></code> instead of <code class="docutils literal notranslate"><span class="pre">__init__</span></code> to prevent a crash due to bad initialization order (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/249">https://github.com/ansible-collections/community.docker/pull/249</a>).</p></li>
<li><p>nsenter connection plugin - replace the use of <code class="docutils literal notranslate"><span class="pre">--all-namespaces</span></code> with specific namespaces to support compatibility with Busybox nsenter (used on, for example, Alpine containers) (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/249">https://github.com/ansible-collections/community.docker/pull/249</a>).</p></li>
</ul>
</section>
</section>
<section id="v2-0-1">
<h2><a class="toc-backref" href="#id481" role="doc-backlink">v2.0.1</a><a class="headerlink" href="#v2-0-1" title="Link to this heading"></a></h2>
<section id="id171">
<h3><a class="toc-backref" href="#id482" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id171" title="Link to this heading"></a></h3>
<p>Maintenance release with some documentation fixes.</p>
</section>
</section>
<section id="v2-0-0">
<h2><a class="toc-backref" href="#id483" role="doc-backlink">v2.0.0</a><a class="headerlink" href="#v2-0-0" title="Link to this heading"></a></h2>
<section id="id172">
<h3><a class="toc-backref" href="#id484" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id172" title="Link to this heading"></a></h3>
<p>New major release with some deprecations removed and a breaking change in the <code class="docutils literal notranslate"><span class="pre">docker_compose</span></code> module regarding the <code class="docutils literal notranslate"><span class="pre">timeout</span></code> parameter.</p>
</section>
<section id="id173">
<h3><a class="toc-backref" href="#id485" role="doc-backlink">Breaking Changes / Porting Guide</a><a class="headerlink" href="#id173" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - fixed <code class="docutils literal notranslate"><span class="pre">timeout</span></code> defaulting behavior so that <code class="docutils literal notranslate"><span class="pre">stop_grace_period</span></code>, if defined in the compose file, will be used if <code class="docutils literal notranslate"><span class="pre">timeout</span></code> is not specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/163">https://github.com/ansible-collections/community.docker/pull/163</a>).</p></li>
</ul>
</section>
<section id="id174">
<h3><a class="toc-backref" href="#id486" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id174" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - using the special value <code class="docutils literal notranslate"><span class="pre">all</span></code> in <code class="docutils literal notranslate"><span class="pre">published_ports</span></code> has been deprecated. Use <code class="docutils literal notranslate"><span class="pre">publish_all_ports=true</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/210">https://github.com/ansible-collections/community.docker/pull/210</a>).</p></li>
</ul>
</section>
<section id="id175">
<h3><a class="toc-backref" href="#id487" role="doc-backlink">Removed Features (previously deprecated)</a><a class="headerlink" href="#id175" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the default value of <code class="docutils literal notranslate"><span class="pre">container_default_behavior</span></code> changed to <code class="docutils literal notranslate"><span class="pre">no_defaults</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/210">https://github.com/ansible-collections/community.docker/pull/210</a>).</p></li>
<li><p>docker_container - the default value of <code class="docutils literal notranslate"><span class="pre">network_mode</span></code> is now the name of the first network specified in <code class="docutils literal notranslate"><span class="pre">networks</span></code> if such are specified and <code class="docutils literal notranslate"><span class="pre">networks_cli_compatible=true</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/210">https://github.com/ansible-collections/community.docker/pull/210</a>).</p></li>
<li><p>docker_container - the special value <code class="docutils literal notranslate"><span class="pre">all</span></code> can no longer be used in <code class="docutils literal notranslate"><span class="pre">published_ports</span></code> next to other values. Please use <code class="docutils literal notranslate"><span class="pre">publish_all_ports=true</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/210">https://github.com/ansible-collections/community.docker/pull/210</a>).</p></li>
<li><p>docker_login - removed the <code class="docutils literal notranslate"><span class="pre">email</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/210">https://github.com/ansible-collections/community.docker/pull/210</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-10-0">
<h2><a class="toc-backref" href="#id488" role="doc-backlink">v1.10.0</a><a class="headerlink" href="#v1-10-0" title="Link to this heading"></a></h2>
<section id="id176">
<h3><a class="toc-backref" href="#id489" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id176" title="Link to this heading"></a></h3>
<p>Regular feature and bugfix release.</p>
</section>
<section id="id177">
<h3><a class="toc-backref" href="#id490" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id177" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Add the modules docker_container_exec, docker_image_load and docker_plugin to the <code class="docutils literal notranslate"><span class="pre">docker</span></code> module defaults group (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/209">https://github.com/ansible-collections/community.docker/pull/209</a>).</p></li>
<li><p>docker_config - add option <code class="docutils literal notranslate"><span class="pre">data_src</span></code> to read configuration data from target (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/64">https://github.com/ansible-collections/community.docker/issues/64</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/203">https://github.com/ansible-collections/community.docker/pull/203</a>).</p></li>
<li><p>docker_secret - add option <code class="docutils literal notranslate"><span class="pre">data_src</span></code> to read secret data from target (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/64">https://github.com/ansible-collections/community.docker/issues/64</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/203">https://github.com/ansible-collections/community.docker/pull/203</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-9-1">
<h2><a class="toc-backref" href="#id491" role="doc-backlink">v1.9.1</a><a class="headerlink" href="#v1-9-1" title="Link to this heading"></a></h2>
<section id="id178">
<h3><a class="toc-backref" href="#id492" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id178" title="Link to this heading"></a></h3>
<p>Regular bugfix release.</p>
</section>
<section id="id179">
<h3><a class="toc-backref" href="#id493" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id179" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - fixed incorrect <code class="docutils literal notranslate"><span class="pre">changed</span></code> status for services with <code class="docutils literal notranslate"><span class="pre">profiles</span></code> defined, but none enabled (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/192">https://github.com/ansible-collections/community.docker/pull/192</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-9-0">
<h2><a class="toc-backref" href="#id494" role="doc-backlink">v1.9.0</a><a class="headerlink" href="#v1-9-0" title="Link to this heading"></a></h2>
<section id="id180">
<h3><a class="toc-backref" href="#id495" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id180" title="Link to this heading"></a></h3>
<p>New bugfixes and features release.</p>
</section>
<section id="id181">
<h3><a class="toc-backref" href="#id496" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id181" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_* modules - include <code class="docutils literal notranslate"><span class="pre">ImportError</span></code> traceback when reporting that Docker SDK for Python could not be found (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/188">https://github.com/ansible-collections/community.docker/pull/188</a>).</p></li>
<li><p>docker_compose - added <code class="docutils literal notranslate"><span class="pre">env_file</span></code> option for specifying custom environment files (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/174">https://github.com/ansible-collections/community.docker/pull/174</a>).</p></li>
<li><p>docker_container - added <code class="docutils literal notranslate"><span class="pre">publish_all_ports</span></code> option to publish all exposed ports to random ports except those explicitly bound with <code class="docutils literal notranslate"><span class="pre">published_ports</span></code> (this was already added in community.docker 1.8.0) (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/162">https://github.com/ansible-collections/community.docker/pull/162</a>).</p></li>
<li><p>docker_container - added new <code class="docutils literal notranslate"><span class="pre">command_handling</span></code> option with current deprecated default value <code class="docutils literal notranslate"><span class="pre">compatibility</span></code> which allows to control how the module handles shell quoting when interpreting lists, and how the module handles empty lists/strings. The default will switch to <code class="docutils literal notranslate"><span class="pre">correct</span></code> in community.docker 3.0.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/186">https://github.com/ansible-collections/community.docker/pull/186</a>).</p></li>
<li><p>docker_container - lifted restriction preventing the creation of anonymous volumes with the <code class="docutils literal notranslate"><span class="pre">mounts</span></code> option (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/181">https://github.com/ansible-collections/community.docker/pull/181</a>).</p></li>
</ul>
</section>
<section id="id182">
<h3><a class="toc-backref" href="#id497" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id182" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the new <code class="docutils literal notranslate"><span class="pre">command_handling</span></code>’s default value, <code class="docutils literal notranslate"><span class="pre">compatibility</span></code>, is deprecated and will change to <code class="docutils literal notranslate"><span class="pre">correct</span></code> in community.docker 3.0.0. A deprecation warning is emitted by the module in cases where the behavior will change. Please note that ansible-core will output a deprecation warning only once, so if it is shown for an earlier task, there could be more tasks with this warning where it is not shown (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/186">https://github.com/ansible-collections/community.docker/pull/186</a>).</p></li>
</ul>
</section>
<section id="id183">
<h3><a class="toc-backref" href="#id498" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id183" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - fixes task failures when bringing up services while using <code class="docutils literal notranslate"><span class="pre">docker-compose</span> <span class="pre">&lt;1.17.0</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/180">https://github.com/ansible-collections/community.docker/issues/180</a>).</p></li>
<li><p>docker_container - make sure to also return <code class="docutils literal notranslate"><span class="pre">container</span></code> on <code class="docutils literal notranslate"><span class="pre">detached=false</span></code> when status code is non-zero (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/178">https://github.com/ansible-collections/community.docker/pull/178</a>).</p></li>
<li><p>docker_stack_info - make sure that module isn’t skipped in check mode (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/183">https://github.com/ansible-collections/community.docker/pull/183</a>).</p></li>
<li><p>docker_stack_task_info - make sure that module isn’t skipped in check mode (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/183">https://github.com/ansible-collections/community.docker/pull/183</a>).</p></li>
</ul>
</section>
<section id="new-plugins">
<h3><a class="toc-backref" href="#id499" role="doc-backlink">New Plugins</a><a class="headerlink" href="#new-plugins" title="Link to this heading"></a></h3>
<section id="connection">
<h4><a class="toc-backref" href="#id500" role="doc-backlink">Connection</a><a class="headerlink" href="#connection" title="Link to this heading"></a></h4>
<ul class="simple">
<li><p>community.docker.nsenter - execute on host running controller container</p></li>
</ul>
</section>
</section>
</section>
<section id="v1-8-0">
<h2><a class="toc-backref" href="#id501" role="doc-backlink">v1.8.0</a><a class="headerlink" href="#v1-8-0" title="Link to this heading"></a></h2>
<section id="id184">
<h3><a class="toc-backref" href="#id502" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id184" title="Link to this heading"></a></h3>
<p>Regular bugfix and feature release.</p>
</section>
<section id="id185">
<h3><a class="toc-backref" href="#id503" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id185" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Avoid internal ansible-core module_utils in favor of equivalent public API available since at least Ansible 2.9 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/164">https://github.com/ansible-collections/community.docker/pull/164</a>).</p></li>
<li><p>docker_compose - added <code class="docutils literal notranslate"><span class="pre">profiles</span></code> option to specify service profiles when starting services (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/167">https://github.com/ansible-collections/community.docker/pull/167</a>).</p></li>
<li><p>docker_containers inventory plugin - when <code class="docutils literal notranslate"><span class="pre">connection_type=docker-api</span></code>, now pass Docker daemon connection options from inventory plugin to connection plugin. This can be disabled by setting <code class="docutils literal notranslate"><span class="pre">configure_docker_daemon=false</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/157">https://github.com/ansible-collections/community.docker/pull/157</a>).</p></li>
<li><p>docker_host_info - allow values for keys in <code class="docutils literal notranslate"><span class="pre">containers_filters</span></code>, <code class="docutils literal notranslate"><span class="pre">images_filters</span></code>, <code class="docutils literal notranslate"><span class="pre">networks_filters</span></code>, and <code class="docutils literal notranslate"><span class="pre">volumes_filters</span></code> to be passed as YAML lists (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/160">https://github.com/ansible-collections/community.docker/pull/160</a>).</p></li>
<li><p>docker_plugin - added <code class="docutils literal notranslate"><span class="pre">alias</span></code> option to specify local names for docker plugins (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/161">https://github.com/ansible-collections/community.docker/pull/161</a>).</p></li>
</ul>
</section>
<section id="id186">
<h3><a class="toc-backref" href="#id504" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id186" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_compose - fix idempotence bug when using <code class="docutils literal notranslate"><span class="pre">stopped:</span> <span class="pre">true</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/142">https://github.com/ansible-collections/community.docker/issues/142</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/159">https://github.com/ansible-collections/community.docker/pull/159</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-7-0">
<h2><a class="toc-backref" href="#id505" role="doc-backlink">v1.7.0</a><a class="headerlink" href="#v1-7-0" title="Link to this heading"></a></h2>
<section id="id187">
<h3><a class="toc-backref" href="#id506" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id187" title="Link to this heading"></a></h3>
<p>Small feature and bugfix release.</p>
</section>
<section id="id188">
<h3><a class="toc-backref" href="#id507" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id188" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_image - allow to tag images by ID (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/149">https://github.com/ansible-collections/community.docker/pull/149</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-6-1">
<h2><a class="toc-backref" href="#id508" role="doc-backlink">v1.6.1</a><a class="headerlink" href="#v1-6-1" title="Link to this heading"></a></h2>
<section id="id189">
<h3><a class="toc-backref" href="#id509" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id189" title="Link to this heading"></a></h3>
<p>Bugfix release to reduce deprecation warning spam.</p>
</section>
<section id="id190">
<h3><a class="toc-backref" href="#id510" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id190" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_* modules and plugins, except <code class="docutils literal notranslate"><span class="pre">docker_swarm</span></code> connection plugin and <code class="docutils literal notranslate"><span class="pre">docker_compose</span></code> and <code class="docutils literal notranslate"><span class="pre">docker_stack*`</span> <span class="pre">modules</span> <span class="pre">-</span> <span class="pre">only</span> <span class="pre">emit</span> <span class="pre">``tls_hostname</span></code> deprecation message if TLS is actually used (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/143">https://github.com/ansible-collections/community.docker/pull/143</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-6-0">
<h2><a class="toc-backref" href="#id511" role="doc-backlink">v1.6.0</a><a class="headerlink" href="#v1-6-0" title="Link to this heading"></a></h2>
<section id="id191">
<h3><a class="toc-backref" href="#id512" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id191" title="Link to this heading"></a></h3>
<p>Regular bugfix and feature release.</p>
</section>
<section id="id192">
<h3><a class="toc-backref" href="#id513" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id192" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>common module utils - correct error messages for guiding to install proper Docker SDK for Python module (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/125">https://github.com/ansible-collections/community.docker/pull/125</a>).</p></li>
<li><p>docker_container - allow <code class="docutils literal notranslate"><span class="pre">memory_swap:</span> <span class="pre">-1</span></code> to set memory swap limit to unlimited. This is useful when the user cannot set memory swap limits due to cgroup limitations or other reasons, as by default Docker will try to set swap usage to two times the value of <code class="docutils literal notranslate"><span class="pre">memory</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/138">https://github.com/ansible-collections/community.docker/pull/138</a>).</p></li>
</ul>
</section>
<section id="id193">
<h3><a class="toc-backref" href="#id514" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id193" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_* modules and plugins, except <code class="docutils literal notranslate"><span class="pre">docker_swarm</span></code> connection plugin and <code class="docutils literal notranslate"><span class="pre">docker_compose</span></code> and <code class="docutils literal notranslate"><span class="pre">docker_stack*`</span> <span class="pre">modules</span> <span class="pre">-</span> <span class="pre">the</span> <span class="pre">current</span> <span class="pre">default</span> <span class="pre">``localhost</span></code> for <code class="docutils literal notranslate"><span class="pre">tls_hostname</span></code> is deprecated. In community.docker 2.0.0 it will be computed from <code class="docutils literal notranslate"><span class="pre">docker_host</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/134">https://github.com/ansible-collections/community.docker/pull/134</a>).</p></li>
</ul>
</section>
<section id="id194">
<h3><a class="toc-backref" href="#id515" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id194" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker-compose - fix not pulling when <code class="docutils literal notranslate"><span class="pre">state:</span> <span class="pre">present</span></code> and <code class="docutils literal notranslate"><span class="pre">stopped:</span> <span class="pre">true</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/12">https://github.com/ansible-collections/community.docker/issues/12</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/119">https://github.com/ansible-collections/community.docker/pull/119</a>).</p></li>
<li><p>docker_plugin - also configure plugin after installing (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/118">https://github.com/ansible-collections/community.docker/issues/118</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/135">https://github.com/ansible-collections/community.docker/pull/135</a>).</p></li>
<li><p>docker_swarm_services - avoid crash during idempotence check if <code class="docutils literal notranslate"><span class="pre">published_port</span></code> is not specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/107">https://github.com/ansible-collections/community.docker/issues/107</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/136">https://github.com/ansible-collections/community.docker/pull/136</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-5-0">
<h2><a class="toc-backref" href="#id516" role="doc-backlink">v1.5.0</a><a class="headerlink" href="#v1-5-0" title="Link to this heading"></a></h2>
<section id="id195">
<h3><a class="toc-backref" href="#id517" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id195" title="Link to this heading"></a></h3>
<p>Regular feature release.</p>
</section>
<section id="id196">
<h3><a class="toc-backref" href="#id518" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id196" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Add the <code class="docutils literal notranslate"><span class="pre">use_ssh_client</span></code> option to most docker modules and plugins (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/108">https://github.com/ansible-collections/community.docker/issues/108</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/114">https://github.com/ansible-collections/community.docker/pull/114</a>).</p></li>
</ul>
</section>
<section id="id197">
<h3><a class="toc-backref" href="#id519" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id197" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>all modules - use <code class="docutils literal notranslate"><span class="pre">to_native</span></code> to convert exceptions to strings (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/121">https://github.com/ansible-collections/community.docker/pull/121</a>).</p></li>
</ul>
</section>
<section id="id198">
<h3><a class="toc-backref" href="#id520" role="doc-backlink">New Modules</a><a class="headerlink" href="#id198" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_container_exec - Execute command in a docker container</p></li>
</ul>
</section>
</section>
<section id="v1-4-0">
<h2><a class="toc-backref" href="#id521" role="doc-backlink">v1.4.0</a><a class="headerlink" href="#v1-4-0" title="Link to this heading"></a></h2>
<section id="id199">
<h3><a class="toc-backref" href="#id522" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id199" title="Link to this heading"></a></h3>
<p>Security release to address another potential secret leak. Also includes regular bugfixes and features.</p>
</section>
<section id="id200">
<h3><a class="toc-backref" href="#id523" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id200" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm_service - change <code class="docutils literal notranslate"><span class="pre">publish.published_port</span></code> option from mandatory to optional. Docker will assign random high port if not specified (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/99">https://github.com/ansible-collections/community.docker/issues/99</a>).</p></li>
</ul>
</section>
<section id="id201">
<h3><a class="toc-backref" href="#id524" role="doc-backlink">Breaking Changes / Porting Guide</a><a class="headerlink" href="#id201" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm - if <code class="docutils literal notranslate"><span class="pre">join_token</span></code> is specified, a returned join token with the same value will be replaced by <code class="docutils literal notranslate"><span class="pre">VALUE_SPECIFIED_IN_NO_LOG_PARAMETER</span></code>. Make sure that you do not blindly use the join tokens from the return value of this module when the module is invoked with <code class="docutils literal notranslate"><span class="pre">join_token</span></code> specified! This breaking change appears in a minor release since it is necessary to fix a security issue (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/103">https://github.com/ansible-collections/community.docker/pull/103</a>).</p></li>
</ul>
</section>
<section id="id202">
<h3><a class="toc-backref" href="#id525" role="doc-backlink">Security Fixes</a><a class="headerlink" href="#id202" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm - the <code class="docutils literal notranslate"><span class="pre">join_token</span></code> option is now marked as <code class="docutils literal notranslate"><span class="pre">no_log</span></code> so it is no longer written into logs (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/103">https://github.com/ansible-collections/community.docker/pull/103</a>).</p></li>
</ul>
</section>
<section id="id203">
<h3><a class="toc-backref" href="#id526" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id203" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">docker_swarm_service</span></code> - fix KeyError on caused by reference to deprecated option <code class="docutils literal notranslate"><span class="pre">update_failure_action</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/100">https://github.com/ansible-collections/community.docker/pull/100</a>).</p></li>
<li><p>docker_swarm_service - mark <code class="docutils literal notranslate"><span class="pre">secrets</span></code> module option with <code class="docutils literal notranslate"><span class="pre">no_log=False</span></code> since it does not leak secrets (<a class="reference external" href="https://github.com/ansible-collections/community.general/pull/2001">https://github.com/ansible-collections/community.general/pull/2001</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-3-0">
<h2><a class="toc-backref" href="#id527" role="doc-backlink">v1.3.0</a><a class="headerlink" href="#v1-3-0" title="Link to this heading"></a></h2>
<section id="id204">
<h3><a class="toc-backref" href="#id528" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id204" title="Link to this heading"></a></h3>
<p>Regular feature and bugfix release.</p>
</section>
<section id="id205">
<h3><a class="toc-backref" href="#id529" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id205" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - add <code class="docutils literal notranslate"><span class="pre">storage_opts</span></code> option to specify storage options (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/91">https://github.com/ansible-collections/community.docker/issues/91</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/93">https://github.com/ansible-collections/community.docker/pull/93</a>).</p></li>
<li><p>docker_image - allows to specify platform to pull for <code class="docutils literal notranslate"><span class="pre">source=pull</span></code> with new option <code class="docutils literal notranslate"><span class="pre">pull_platform</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/79">https://github.com/ansible-collections/community.docker/issues/79</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/89">https://github.com/ansible-collections/community.docker/pull/89</a>).</p></li>
<li><p>docker_image - properly support image IDs (hashes) for loading and tagging images (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/86">https://github.com/ansible-collections/community.docker/issues/86</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/87">https://github.com/ansible-collections/community.docker/pull/87</a>).</p></li>
<li><p>docker_swarm_service - adding support for maximum number of tasks per node (<code class="docutils literal notranslate"><span class="pre">replicas_max_per_node</span></code>) when running swarm service in replicated mode. Introduced in API 1.40 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/7">https://github.com/ansible-collections/community.docker/issues/7</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/92">https://github.com/ansible-collections/community.docker/pull/92</a>).</p></li>
</ul>
</section>
<section id="id206">
<h3><a class="toc-backref" href="#id530" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id206" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - fix healthcheck disabling idempotency issue with strict comparison (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/85">https://github.com/ansible-collections/community.docker/issues/85</a>).</p></li>
<li><p>docker_image - prevent module failure when removing image that is removed between inspection and removal (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/87">https://github.com/ansible-collections/community.docker/pull/87</a>).</p></li>
<li><p>docker_image - prevent module failure when removing non-existent image by ID (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/87">https://github.com/ansible-collections/community.docker/pull/87</a>).</p></li>
<li><p>docker_image_info - prevent module failure when image vanishes between listing and inspection (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/87">https://github.com/ansible-collections/community.docker/pull/87</a>).</p></li>
<li><p>docker_image_info - prevent module failure when querying non-existent image by ID (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/87">https://github.com/ansible-collections/community.docker/pull/87</a>).</p></li>
</ul>
</section>
<section id="id207">
<h3><a class="toc-backref" href="#id531" role="doc-backlink">New Modules</a><a class="headerlink" href="#id207" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.docker_image_load - Load docker image(s) from archives</p></li>
<li><p>community.docker.docker_plugin - Manage Docker plugins</p></li>
</ul>
</section>
</section>
<section id="v1-2-2">
<h2><a class="toc-backref" href="#id532" role="doc-backlink">v1.2.2</a><a class="headerlink" href="#v1-2-2" title="Link to this heading"></a></h2>
<section id="id208">
<h3><a class="toc-backref" href="#id533" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id208" title="Link to this heading"></a></h3>
<p>Security bugfix release to address CVE-2021-20191.</p>
</section>
<section id="id209">
<h3><a class="toc-backref" href="#id534" role="doc-backlink">Security Fixes</a><a class="headerlink" href="#id209" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_swarm - enabled <code class="docutils literal notranslate"><span class="pre">no_log</span></code> for the option <code class="docutils literal notranslate"><span class="pre">signing_ca_key</span></code> to prevent accidental disclosure (CVE-2021-20191, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/80">https://github.com/ansible-collections/community.docker/pull/80</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-2-1">
<h2><a class="toc-backref" href="#id535" role="doc-backlink">v1.2.1</a><a class="headerlink" href="#v1-2-1" title="Link to this heading"></a></h2>
<section id="id210">
<h3><a class="toc-backref" href="#id536" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id210" title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<section id="id211">
<h3><a class="toc-backref" href="#id537" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id211" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker connection plugin - fix Docker version parsing, as some docker versions have a leading <code class="docutils literal notranslate"><span class="pre">v</span></code> in the output of the command <code class="docutils literal notranslate"><span class="pre">docker</span> <span class="pre">version</span> <span class="pre">--format</span> <span class="pre">&quot;{{.Server.Version}}&quot;</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/76">https://github.com/ansible-collections/community.docker/pull/76</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-2-0">
<h2><a class="toc-backref" href="#id538" role="doc-backlink">v1.2.0</a><a class="headerlink" href="#v1-2-0" title="Link to this heading"></a></h2>
<section id="id212">
<h3><a class="toc-backref" href="#id539" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id212" title="Link to this heading"></a></h3>
<p>Feature release with one new feature and two bugfixes.</p>
</section>
<section id="id213">
<h3><a class="toc-backref" href="#id540" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id213" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - added <code class="docutils literal notranslate"><span class="pre">default_host_ip</span></code> option which allows to explicitly set the default IP string for published ports without explicitly specified IPs. When using IPv6 binds with Docker 20.10.2 or newer, this needs to be set to an empty string (<code class="docutils literal notranslate"><span class="pre">&quot;&quot;</span></code>) (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/70">https://github.com/ansible-collections/community.docker/issues/70</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/71">https://github.com/ansible-collections/community.docker/pull/71</a>).</p></li>
</ul>
</section>
<section id="id214">
<h3><a class="toc-backref" href="#id541" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id214" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - allow IPv6 zones (RFC 4007) in bind IPs (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/66">https://github.com/ansible-collections/community.docker/pull/66</a>).</p></li>
<li><p>docker_image - fix crash on loading images with versions of Docker SDK for Python before 2.5.0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/72">https://github.com/ansible-collections/community.docker/issues/72</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/73">https://github.com/ansible-collections/community.docker/pull/73</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-1-0">
<h2><a class="toc-backref" href="#id542" role="doc-backlink">v1.1.0</a><a class="headerlink" href="#v1-1-0" title="Link to this heading"></a></h2>
<section id="id215">
<h3><a class="toc-backref" href="#id543" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id215" title="Link to this heading"></a></h3>
<p>Feature release with three new plugins and modules.</p>
</section>
<section id="id216">
<h3><a class="toc-backref" href="#id544" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id216" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - support specifying <code class="docutils literal notranslate"><span class="pre">cgroup_parent</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/6">https://github.com/ansible-collections/community.docker/issues/6</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/59">https://github.com/ansible-collections/community.docker/pull/59</a>).</p></li>
<li><p>docker_container - when a container is started with <code class="docutils literal notranslate"><span class="pre">detached=false</span></code>, <code class="docutils literal notranslate"><span class="pre">status</span></code> is now also returned when it is 0 (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/26">https://github.com/ansible-collections/community.docker/issues/26</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/58">https://github.com/ansible-collections/community.docker/pull/58</a>).</p></li>
<li><p>docker_image - support <code class="docutils literal notranslate"><span class="pre">platform</span></code> when building images (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/22">https://github.com/ansible-collections/community.docker/issues/22</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/54">https://github.com/ansible-collections/community.docker/pull/54</a>).</p></li>
</ul>
</section>
<section id="id217">
<h3><a class="toc-backref" href="#id545" role="doc-backlink">Deprecated Features</a><a class="headerlink" href="#id217" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - currently <code class="docutils literal notranslate"><span class="pre">published_ports</span></code> can contain port mappings next to the special value <code class="docutils literal notranslate"><span class="pre">all</span></code>, in which case the port mappings are ignored. This behavior is deprecated for community.docker 2.0.0, at which point it will either be forbidden, or this behavior will be properly implemented similar to how the Docker CLI tool handles this (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/8">https://github.com/ansible-collections/community.docker/issues/8</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/60">https://github.com/ansible-collections/community.docker/pull/60</a>).</p></li>
</ul>
</section>
<section id="id218">
<h3><a class="toc-backref" href="#id546" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id218" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_image - if <code class="docutils literal notranslate"><span class="pre">push=true</span></code> is used with <code class="docutils literal notranslate"><span class="pre">repository</span></code>, and the image does not need to be tagged, still push. This can happen if <code class="docutils literal notranslate"><span class="pre">repository</span></code> and <code class="docutils literal notranslate"><span class="pre">name</span></code> are equal (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/52">https://github.com/ansible-collections/community.docker/issues/52</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/53">https://github.com/ansible-collections/community.docker/pull/53</a>).</p></li>
<li><p>docker_image - report error when loading a broken archive that contains no image (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/46">https://github.com/ansible-collections/community.docker/issues/46</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/55">https://github.com/ansible-collections/community.docker/pull/55</a>).</p></li>
<li><p>docker_image - report error when the loaded archive does not contain the specified image (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/41">https://github.com/ansible-collections/community.docker/issues/41</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/55">https://github.com/ansible-collections/community.docker/pull/55</a>).</p></li>
</ul>
</section>
<section id="id219">
<h3><a class="toc-backref" href="#id547" role="doc-backlink">New Plugins</a><a class="headerlink" href="#id219" title="Link to this heading"></a></h3>
<section id="id220">
<h4><a class="toc-backref" href="#id548" role="doc-backlink">Connection</a><a class="headerlink" href="#id220" title="Link to this heading"></a></h4>
<ul class="simple">
<li><p>community.docker.docker_api - Run tasks in docker containers</p></li>
</ul>
</section>
<section id="inventory">
<h4><a class="toc-backref" href="#id549" role="doc-backlink">Inventory</a><a class="headerlink" href="#inventory" title="Link to this heading"></a></h4>
<ul class="simple">
<li><p>community.docker.docker_containers - Ansible dynamic inventory plugin for Docker containers.</p></li>
</ul>
</section>
</section>
<section id="id221">
<h3><a class="toc-backref" href="#id550" role="doc-backlink">New Modules</a><a class="headerlink" href="#id221" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>community.docker.current_container_facts - Return facts about whether the module runs in a Docker container</p></li>
</ul>
</section>
</section>
<section id="v1-0-1">
<h2><a class="toc-backref" href="#id551" role="doc-backlink">v1.0.1</a><a class="headerlink" href="#v1-0-1" title="Link to this heading"></a></h2>
<section id="id222">
<h3><a class="toc-backref" href="#id552" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id222" title="Link to this heading"></a></h3>
<p>Maintenance release with a bugfix for <code class="docutils literal notranslate"><span class="pre">docker_container</span></code>.</p>
</section>
<section id="id223">
<h3><a class="toc-backref" href="#id553" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id223" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - the validation for <code class="docutils literal notranslate"><span class="pre">capabilities</span></code> in <code class="docutils literal notranslate"><span class="pre">device_requests</span></code> was incorrect (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/42">https://github.com/ansible-collections/community.docker/issues/42</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/43">https://github.com/ansible-collections/community.docker/pull/43</a>).</p></li>
</ul>
</section>
</section>
<section id="v1-0-0">
<h2><a class="toc-backref" href="#id554" role="doc-backlink">v1.0.0</a><a class="headerlink" href="#v1-0-0" title="Link to this heading"></a></h2>
<section id="id224">
<h3><a class="toc-backref" href="#id555" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id224" title="Link to this heading"></a></h3>
<p>This is the first production (non-prerelease) release of <code class="docutils literal notranslate"><span class="pre">community.docker</span></code>.</p>
</section>
<section id="id225">
<h3><a class="toc-backref" href="#id556" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id225" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>Add collection-side support of the <code class="docutils literal notranslate"><span class="pre">docker</span></code> action group / module defaults group (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/17">https://github.com/ansible-collections/community.docker/pull/17</a>).</p></li>
<li><p>docker_image - return docker build output (<a class="reference external" href="https://github.com/ansible-collections/community.general/pull/805">https://github.com/ansible-collections/community.general/pull/805</a>).</p></li>
<li><p>docker_secret - add a warning when the secret does not have an <code class="docutils literal notranslate"><span class="pre">ansible_key</span></code> label but the <code class="docutils literal notranslate"><span class="pre">force</span></code> parameter is not set (<a class="reference external" href="https://github.com/ansible-collections/community.docker/issues/30">https://github.com/ansible-collections/community.docker/issues/30</a>, <a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/31">https://github.com/ansible-collections/community.docker/pull/31</a>).</p></li>
</ul>
</section>
</section>
<section id="v0-1-0">
<h2><a class="toc-backref" href="#id557" role="doc-backlink">v0.1.0</a><a class="headerlink" href="#v0-1-0" title="Link to this heading"></a></h2>
<section id="id226">
<h3><a class="toc-backref" href="#id558" role="doc-backlink">Release Summary</a><a class="headerlink" href="#id226" title="Link to this heading"></a></h3>
<p>The <code class="docutils literal notranslate"><span class="pre">community.docker</span></code> continues the work on the Ansible docker modules and plugins from their state in <code class="docutils literal notranslate"><span class="pre">community.general</span></code> 1.2.0. The changes listed here are thus relative to the modules and plugins <code class="docutils literal notranslate"><span class="pre">community.general.docker*</span></code>.</p>
<p>All deprecation removals planned for <code class="docutils literal notranslate"><span class="pre">community.general</span></code> 2.0.0 have been applied. All deprecation removals scheduled for <code class="docutils literal notranslate"><span class="pre">community.general</span></code> 3.0.0 have been re-scheduled for <code class="docutils literal notranslate"><span class="pre">community.docker</span></code> 2.0.0.</p>
</section>
<section id="id227">
<h3><a class="toc-backref" href="#id559" role="doc-backlink">Minor Changes</a><a class="headerlink" href="#id227" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - now supports the <code class="docutils literal notranslate"><span class="pre">device_requests</span></code> option, which allows to request additional resources such as GPUs (<a class="reference external" href="https://github.com/ansible/ansible/issues/65748">https://github.com/ansible/ansible/issues/65748</a>, <a class="reference external" href="https://github.com/ansible-collections/community.general/pull/1119">https://github.com/ansible-collections/community.general/pull/1119</a>).</p></li>
</ul>
</section>
<section id="id228">
<h3><a class="toc-backref" href="#id560" role="doc-backlink">Removed Features (previously deprecated)</a><a class="headerlink" href="#id228" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_container - no longer returns <code class="docutils literal notranslate"><span class="pre">ansible_facts</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_container - the default of <code class="docutils literal notranslate"><span class="pre">networks_cli_compatible</span></code> changed to <code class="docutils literal notranslate"><span class="pre">true</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_container - the unused option <code class="docutils literal notranslate"><span class="pre">trust_image_content</span></code> has been removed (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - <code class="docutils literal notranslate"><span class="pre">state=build</span></code> has been removed. Use <code class="docutils literal notranslate"><span class="pre">present</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - the <code class="docutils literal notranslate"><span class="pre">container_limits</span></code>, <code class="docutils literal notranslate"><span class="pre">dockerfile</span></code>, <code class="docutils literal notranslate"><span class="pre">http_timeout</span></code>, <code class="docutils literal notranslate"><span class="pre">nocache</span></code>, <code class="docutils literal notranslate"><span class="pre">rm</span></code>, <code class="docutils literal notranslate"><span class="pre">path</span></code>, <code class="docutils literal notranslate"><span class="pre">buildargs</span></code>, <code class="docutils literal notranslate"><span class="pre">pull</span></code> have been removed. Use the corresponding suboptions of <code class="docutils literal notranslate"><span class="pre">build</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - the <code class="docutils literal notranslate"><span class="pre">force</span></code> option has been removed. Use the more specific <code class="docutils literal notranslate"><span class="pre">force_*</span></code> options instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - the <code class="docutils literal notranslate"><span class="pre">source</span></code> option is now mandatory (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - the <code class="docutils literal notranslate"><span class="pre">use_tls</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">tls</span></code> and <code class="docutils literal notranslate"><span class="pre">validate_certs</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image - the default of the <code class="docutils literal notranslate"><span class="pre">build.pull</span></code> option changed to <code class="docutils literal notranslate"><span class="pre">false</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_image_facts - this alias is on longer available, use <code class="docutils literal notranslate"><span class="pre">docker_image_info</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_network - no longer returns <code class="docutils literal notranslate"><span class="pre">ansible_facts</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_network - the <code class="docutils literal notranslate"><span class="pre">ipam_options</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">ipam_config</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_service - no longer returns <code class="docutils literal notranslate"><span class="pre">ansible_facts</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm - <code class="docutils literal notranslate"><span class="pre">state=inspect</span></code> has been removed. Use <code class="docutils literal notranslate"><span class="pre">docker_swarm_info</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">constraints</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">placement.constraints</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">limit_cpu</span></code> and <code class="docutils literal notranslate"><span class="pre">limit_memory</span></code> options has been removed. Use the corresponding suboptions in <code class="docutils literal notranslate"><span class="pre">limits</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">log_driver</span></code> and <code class="docutils literal notranslate"><span class="pre">log_driver_options</span></code> options has been removed. Use the corresponding suboptions in <code class="docutils literal notranslate"><span class="pre">logging</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">reserve_cpu</span></code> and <code class="docutils literal notranslate"><span class="pre">reserve_memory</span></code> options has been removed. Use the corresponding suboptions in <code class="docutils literal notranslate"><span class="pre">reservations</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">restart_policy</span></code>, <code class="docutils literal notranslate"><span class="pre">restart_policy_attempts</span></code>, <code class="docutils literal notranslate"><span class="pre">restart_policy_delay</span></code> and <code class="docutils literal notranslate"><span class="pre">restart_policy_window</span></code> options has been removed. Use the corresponding suboptions in <code class="docutils literal notranslate"><span class="pre">restart_config</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_swarm_service - the <code class="docutils literal notranslate"><span class="pre">update_delay</span></code>, <code class="docutils literal notranslate"><span class="pre">update_parallelism</span></code>, <code class="docutils literal notranslate"><span class="pre">update_failure_action</span></code>, <code class="docutils literal notranslate"><span class="pre">update_monitor</span></code>, <code class="docutils literal notranslate"><span class="pre">update_max_failure_ratio</span></code> and <code class="docutils literal notranslate"><span class="pre">update_order</span></code> options has been removed. Use the corresponding suboptions in <code class="docutils literal notranslate"><span class="pre">update_config</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_volume - no longer returns <code class="docutils literal notranslate"><span class="pre">ansible_facts</span></code> (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
<li><p>docker_volume - the <code class="docutils literal notranslate"><span class="pre">force</span></code> option has been removed. Use <code class="docutils literal notranslate"><span class="pre">recreate</span></code> instead (<a class="reference external" href="https://github.com/ansible-collections/community.docker/pull/1">https://github.com/ansible-collections/community.docker/pull/1</a>).</p></li>
</ul>
</section>
<section id="id229">
<h3><a class="toc-backref" href="#id561" role="doc-backlink">Bugfixes</a><a class="headerlink" href="#id229" title="Link to this heading"></a></h3>
<ul class="simple">
<li><p>docker_login - fix internal config file storage to handle credentials for more than one registry (<a class="reference external" href="https://github.com/ansible-collections/community.general/issues/1117">https://github.com/ansible-collections/community.general/issues/1117</a>).</p></li>
</ul>
</section>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="index.html" class="btn btn-neutral float-left" title="Community.Docker" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="docsite/scenario_guide.html" class="btn btn-neutral float-right" title="Docker Guide" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>&#169; Copyright Community.Docker Contributors.</p>
</div>
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script><!-- extra footer elements for Ansible beyond RTD Sphinx Theme -->
</body>
</html>
View Git Blame Copy Permalink