blob: 701be387b3888bb099d2f242449e969527391fee [file] [log] [blame]
<!DOCTYPE html>
<!--
-
- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements. See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership. The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing,
- software distributed under the License is distributed on an
- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- KIND, either express or implied. See the License for the
- specific language governing permissions and limitations
- under the License.
-
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>Chapter 12. Docker Images - Apache Qpid&#8482;</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
<link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
<script type="text/javascript">var _deferredFunctions = [];</script>
<script type="text/javascript" src="/deferred.js" defer="defer"></script>
<!--[if lte IE 8]>
<link rel="stylesheet" href="/ie.css" type="text/css"/>
<script type="text/javascript" src="/html5shiv.js"></script>
<![endif]-->
<!-- Redirects for `go get` and godoc.org -->
<meta name="go-import"
content="qpid.apache.org git https://gitbox.apache.org/repos/asf/qpid-proton.git"/>
<meta name="go-source"
content="qpid.apache.org
https://github.com/apache/qpid-proton/blob/go1/README.md
https://github.com/apache/qpid-proton/tree/go1{/dir}
https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/>
</head>
<body>
<div id="-content">
<div id="-top" class="panel">
<a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
<a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a>
<ul id="-global-navigation">
<li><a id="-logotype" href="/index.html">Apache Qpid<sup>&#8482;</sup></a></li>
<li><a href="/documentation.html">Documentation</a></li>
<li><a href="/download.html">Download</a></li>
<li><a href="/discussion.html">Discussion</a></li>
</ul>
</div>
<div id="-menu" class="panel" style="display: none;">
<div class="flex">
<section>
<h3>Project</h3>
<ul>
<li><a href="/overview.html">Overview</a></li>
<li><a href="/components/index.html">Components</a></li>
<li><a href="/releases/index.html">Releases</a></li>
</ul>
</section>
<section>
<h3>Messaging APIs</h3>
<ul>
<li><a href="/proton/index.html">Qpid Proton</a></li>
<li><a href="/components/jms/index.html">Qpid JMS</a></li>
<li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li>
</ul>
</section>
<section>
<h3>Servers and tools</h3>
<ul>
<li><a href="/components/broker-j/index.html">Broker-J</a></li>
<li><a href="/components/cpp-broker/index.html">C++ broker</a></li>
<li><a href="/components/dispatch-router/index.html">Dispatch router</a></li>
</ul>
</section>
<section>
<h3>Resources</h3>
<ul>
<li><a href="/dashboard.html">Dashboard</a></li>
<li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li>
<li><a href="/resources.html">More resources</a></li>
</ul>
</section>
</div>
</div>
<div id="-search" class="panel" style="display: none;">
<form action="http://www.google.com/search" method="get">
<input type="hidden" name="sitesearch" value="qpid.apache.org"/>
<input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/>
<button type="submit">Search</button>
<a href="/search.html">More ways to search</a>
</form>
</div>
<div id="-middle" class="panel">
<ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-broker-j-9.2.0/index.html">Qpid Broker-J 9.2.0</a></li><li><a href="/releases/qpid-broker-j-9.2.0/book/index.html">Apache Qpid Broker-J</a></li><li>Chapter 12. Docker Images</li></ul>
<div id="-middle-content">
<div class="docbook"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 12. Docker Images</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="Java-Broker-Appendix-BDB-HA-initial-configuration-creation.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="Java-Broker-Docker-Running-The-Container.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="Java-Broker-Docker"></a>Chapter 12. Docker Images</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Docker.html#Java-Broker-Docker-Building-Image">12.1. Building Container Image</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Running-The-Container.html">12.2. Running the Container</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Docker-Running-The-Container.html#Java-Broker-Docker-Container-Start">12.2.1. Container Start</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Running-The-Container.html#Java-Broker-Docker-Container-Volume">12.2.2. Container Volume</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Running-The-Container.html#Java-Broker-Docker-Container-Stop">12.2.3. Stopping the Container</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Docker-Broker-Users.html">12.3. Broker Users</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Broker-Customization.html">12.4. Broker Customization</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Docker-Broker-Customization.html#Java-Broker-Docker-Broker-Customization-Exchanges">12.4.1. Exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Broker-Customization.html#Java-Broker-Docker-Broker-Customization-Queues">12.4.2. Queues</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Broker-Customization.html#Java-Broker-Docker-Broker-Customization-Users">12.4.3. Users</a></span></dt><dt><span class="section"><a href="Java-Broker-Docker-Broker-Customization.html#Java-Broker-Docker-Broker-Customization-Override">12.4.4. Overriding Broker Configuration</a></span></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Java-Broker-Docker-Building-Image"></a>12.1. Building Container Image</h2></div></div></div><p>
To use an official Apache release in your image run the following command from the qpid-docker directory where
&lt;QPID_RELEASE_VERSION&gt; is the release version you wish to use (e.g. 9.1.0):
</p><p>
</p><pre class="programlisting">
cd qpid-docker
</pre><p>
</p><p>
</p><pre class="programlisting">
docker-build.sh --release &lt;QPID_RELEASE_VERSION&gt;
</pre><p>
</p><p>
This will download the Qpid Broker-J release and copy all the files necessary to build the pre-configured
Docker image and provide you with additional instructions. Follow these instructions to finish building
the image you want based on the provided Docker file or even one of your own.
</p><p>
If you would rather prefer to build the docker image from local Broker-J distribution, build the parent
project using the command
</p><p>
</p><pre class="programlisting">
mvn clean install -DskipTests=true
</pre><p>
</p><p>
Navigate to the module 'qpid-docker':
</p><p>
</p><pre class="programlisting">
cd qpid-docker
</pre><p>
</p><p>
Execute the command:
</p><p>
</p><pre class="programlisting">
docker-build.sh --local-dist-path &lt;PATH_TO_LOCAL_QPID_DISTRIBUTION&gt;
</pre><p>
</p><p>
This will copy all the files necessary to build the pre-configured Docker image and provide you with additional
instructions. Follow these instructions to finish building the image you want based on one of the provided
Docker file or even one of your own.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Appendix-BDB-HA-initial-configuration-creation.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Docker-Running-The-Container.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">H.2. Creation of BDB HA group using an initial configuration. </td><td width="20%" align="center"><a accesskey="h" href="Apache-Qpid-Broker-J-Book.html">Home</a></td><td width="40%" align="right" valign="top"> 12.2. Running the Container</td></tr></table></div></div>
<hr/>
<ul id="-apache-navigation">
<li><a href="http://www.apache.org/">Apache</a></li>
<li><a href="http://www.apache.org/licenses/">License</a></li>
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li>
<li><a href="/security.html">Security</a></li>
<li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li>
</ul>
<p id="-legal">
Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
The Apache Software Foundation; Licensed under
the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
Proton, Apache, the Apache feather logo, and the Apache Qpid
project logo are trademarks of The Apache Software
Foundation; All other marks mentioned may be trademarks or
registered trademarks of their respective owners
</p>
</div>
</div>
</div>
</body>
</html>