sle2docker 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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
@@ -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
@@ -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