File: Installing_Publican_Docker.xml

package info (click to toggle)
publican 4.3.2-1
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 18,264 kB
  • ctags: 1,303
  • sloc: perl: 13,081; xml: 11,558; makefile: 169; sh: 29; python: 29
file content (63 lines) | stat: -rw-r--r-- 2,345 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section [
<!ENTITY % BOOK_ENTITIES SYSTEM "Users_Guide.ent">
%BOOK_ENTITIES;
<!ENTITY % sgml.features "IGNORE">
<!ENTITY % xml.features "INCLUDE">
<!ENTITY % DOCBOOK_ENTS PUBLIC "-//OASIS//ENTITIES DocBook Character Entities V4.5//EN" "/usr/share/xml/docbook/schema/dtd/4.5/dbcentx.mod">
%DOCBOOK_ENTS;
]>
<section conformance="249" version="5.0" xml:id="sect-Users_Guide-Linux_operating_systems-Docker" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
	<info>
		<title>Docker container</title>

	</info>
	 <note>
		<para>
			This installation procedure assumes you have already installed a working docker (see <uri xlink:href="http://docker.io" xmlns:xlink="http://www.w3.org/1999/xlink">http://docker.io</uri>) environment.
		</para>

	</note>
	 <para>
		Docker is a lightweight Jail (currently using LXC) that allows you to install and run <application>publican</application> without installing your main Linux installation with all its dependencies.
	</para>
	 <procedure>
		<step>
			<para>
				Open a terminal.
			</para>

		</step>
		 <step>
			<para>
				Download and install the <application>svendowideit/publican</application> container from <uri xlink:href="https://index.docker.io/u/svendowideit/publican/" xmlns:xlink="http://www.w3.org/1999/xlink">https://index.docker.io/u/svendowideit/publican/</uri>: 
<screen><prompt>$</prompt> <command>docker pull svendowideit/publican</command></screen>
				 This will take some time, as it downloads a fedora based container, and then the dependencies needed for publican
			</para>

		</step>
		 <step>
			<para>
				Add a publican bash alias to simplify your usage:
			</para>
			 
<screen><prompt>$</prompt> <command>echo 'alias publican="docker run -t -i -v $(pwd):/mnt svendowideit/publican"' &gt;&gt; ~/.bashrc</command></screen>
			 <para>
				This alias assumes that you are running <application>publican</application> in the documentation root directory (the one with the publican.cfg file in it.
			</para>

		</step>
		 <step>
			<para>
				now you can use <application>publican</application> as per the documentation:
			</para>
			 
<screen><prompt>$</prompt> <command>publican --version </command>
<computeroutput>version=3.2.1</computeroutput></screen>

		</step>

	</procedure>

</section>