sle2docker 0.2.0 → 0.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/Changelog +6 -1
  3. data/lib/sle2docker/version.rb +1 -1
  4. data/package/sle2docker.8.ronn +104 -0
  5. metadata +3 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 3ba4bc4ef832b69bf18ec9d3ba0fd0b5518ae3d6
4
- data.tar.gz: 712d2fb95e42161a359a2eb0286f2922f22ae054
3
+ metadata.gz: 5712a466172a865182fb1806df79e41822403c38
4
+ data.tar.gz: b61c5ea36c756e5c3a0fe951fd405fd4bb40391c
5
5
  SHA512:
6
- metadata.gz: adf5fa4931a457bcfd3e2d284ed61632f5289fd7a97940b1e9bf68bf21a31773e5b903727ad242374777ffd4053cd221117284d5fdf189647e0de2919cd8d10a
7
- data.tar.gz: e4ccfa007af3e0c836261cd659a7f1a92c1a32de21b792990978d06c539ec0c89c183f870927e320722b1f84f5009f1bcc0559d11c05b7f82996d7edb457fd4a
6
+ metadata.gz: d5b948f2665452b2c4dd0e27cd5850754efd26b74f12ef40f8dbf306ea34730a80f83d7beeb8480979d7e09249aa8a16665b7da472014a0dd84920ef441b7181
7
+ data.tar.gz: d862d199b7eb77112bf9bab047091e0723fa24955de5c48e5d050943dadf935f58283cfc26655d32800f4f40d728f754514a1f9ceb6c27905fc7e0dcf4fd90d6
data/Changelog CHANGED
@@ -1,4 +1,9 @@
1
- Wed Sep 10 22:04:10 CEST 2014 Flavio Castelli <flavio@castelli.name>
1
+ Thu Sep 11 16:09:41 CEST 2014 Flavio Castelli <fcastelli@suse.com>
2
+
3
+ * Version 0.2.1:
4
+ - Added man (8) page for sle2docker
5
+
6
+ Wed Sep 10 22:04:10 CEST 2014 Flavio Castelli <fcastelli@suse.com>
2
7
 
3
8
  * Version 0.2.0:
4
9
  - Handle cli switches using the Thor
data/lib/sle2docker/version.rb CHANGED
@@ -1,5 +1,5 @@
1
1
  module Sle2Docker
2
2
 
3
- VERSION = "0.2.0"
3
+ VERSION = "0.2.1"
4
4
 
5
5
  end
data/package/sle2docker.8.ronn ADDED
@@ -0,0 +1,104 @@
1
+ sle2docker(8) - Create SLE images for Docker
2
+ =======================================================
3
+
4
+ ## SYNOPSIS
5
+
6
+ `sle2docker <commands> [<args>]`
7
+
8
+ ## DESCRIPTION
9
+
10
+ sle2docker is a convenience tool which creates SUSE Linux Enterprise images for
11
+ Docker.
12
+
13
+ The tool relies on KIWI and Docker itself to build the images.
14
+
15
+ Packages can be fetched either from SUSE Customer Center (SCC) or from a local
16
+ Subscription Management Tool (SMT).
17
+
18
+ Using DVD sources is currently unsupported.
19
+
20
+ ## REQUIREMENTS
21
+
22
+ Docker must be running on the system and the user invoking sle2docker must
23
+ have the rights to interact with it.
24
+
25
+ ## USAGE
26
+
27
+ To build a template use the following command:
28
+
29
+ `sle2docker build TEMPLATE`
30
+
31
+ A list of the available templates can be obtained by running:
32
+
33
+ `sle2docker list`
34
+
35
+ A templated rendered with user provided data can be printed by using the
36
+ following command:
37
+
38
+ `sle2docker show TEMPLATE`
39
+
40
+ ## SUSE CUSTOMER CENTER INTEGRATION
41
+
42
+ By default sle2docker downloads all the required packages from SUSE
43
+ Customer Center (SCC). Before the build starts sle2docker ask the user
44
+ his credentials. It is possible to start a build in a non interactive way by
45
+ using the following command:
46
+
47
+ `sle2docker build -u USERNAME -p PASSWORD TEMPLATE_NAME`
48
+
49
+
50
+ ## SUBSCRIPTION MANAGEMENT TOOL INTEGRATION
51
+
52
+ It is possible to download all the required packages from a local
53
+ Subscription Management Tool (SMT) instance:
54
+
55
+ `sle2docker build -s SMT_SERVER_HOSTNAME TEMPLATE`
56
+
57
+ By default sle2docker assumes the contents of the SMT server are served over
58
+ HTTPS. To force the retrieval of the package over plain HTTP use the
59
+ following command:
60
+
61
+ `sle2docker build -s SMT_SERVER_HOSTNAME --disable-https TEMPLATE`
62
+
63
+ By default sle2docker expects the SMT instance to not require any form of
64
+ authentication. However it is possible to specify the access credentials by
65
+ using the following command:
66
+
67
+ `sle2docker build -s SMT_SERVER_HOSTNAME -u USERNAME -p PASSWORD TEMPLATE`
68
+
69
+
70
+ ## EXIT CODES
71
+ sle2docker sets the following exit codes:
72
+
73
+ * 0: Build successful
74
+ * 1: Build failure
75
+
76
+
77
+ ## IMPLEMENTATION
78
+
79
+ sle2docker gem comes with a set of supported SLE templates. These are KIWI
80
+ source files which are filled with the informations provided by the user at
81
+ runtime.
82
+
83
+ The image creation happens inside of the `opensuse/kiwi` Docker image. This has
84
+ to be done because on recent systems (like SLE12) KIWI cannot create SLE11
85
+ images. That happens because building a SLE11 systems requires the
86
+ `db45-utils` package to be installed on the host system; this
87
+ package is obsolete and is not available on SLE12.
88
+
89
+ The Docker image used by sle2docker is based on openSUSE and it's freely
90
+ downloadable from the Docker Hub. The image is built using Docker's build system
91
+ by starting from the official openSUSE image.
92
+ The `Dockerfile` used to create this image can be found inside of
93
+ the https://github.com/openSUSE/docker-containers repository.
94
+
95
+ sle2docker automatically fetches the `opensuse/kiwi` image if not found on the
96
+ system.
97
+
98
+
99
+ ## AUTHOR
100
+ Flavio Castelli <fcastelli@suse.com>
101
+
102
+ ## LINKS
103
+ Project on GitHub: https://github.com/SUSE/sle2docker
104
+
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: sle2docker
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Flavio Castelli
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2014-09-10 00:00:00.000000000 Z
11
+ date: 2014-09-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: thor
@@ -89,6 +89,7 @@ files:
89
89
  - lib/templates/SLE12/config.sh
90
90
  - lib/templates/SLE12/config.xml.erb
91
91
  - lib/templates/SLE12/root/etc/resolv.conf
92
+ - package/sle2docker.8.ronn
92
93
  - sle2docker.gemspec
93
94
  - test/builder_test.rb
94
95
  - test/fixtures/sle11sp3_config.xml