machinery-tool 1.23.1 → 1.24.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (83) hide show
  1. checksums.yaml +5 -5
  2. data/.git_revision +1 -1
  3. data/NEWS +11 -0
  4. data/export_helpers/kiwi_export_readme.md +3 -3
  5. data/export_helpers/merge_users_and_groups.pl.erb +1 -1
  6. data/lib/build_task.rb +5 -3
  7. data/lib/deploy_task.rb +0 -1
  8. data/lib/exceptions.rb +13 -0
  9. data/lib/kiwi_config.rb +3 -9
  10. data/lib/machinery_helper.rb +15 -1
  11. data/lib/remote_system.rb +4 -2
  12. data/lib/system_description.rb +0 -9
  13. data/lib/version.rb +1 -1
  14. data/machinery-helper/version.go +1 -1
  15. data/man/generated/machinery.1.gz +0 -0
  16. data/manual/docs/index.html +2 -8
  17. data/manual/docs/machinery.ymp +10 -10
  18. data/manual/mkdocs.yml +3 -1
  19. data/manual/site/404.html +145 -0
  20. data/manual/site/css/base.css +324 -0
  21. data/manual/site/css/bootstrap-custom.min.css +1 -0
  22. data/manual/site/css/fixed-positioning.css +0 -0
  23. data/manual/site/css/font-awesome.min.css +4 -0
  24. data/manual/site/docs/index.html +25 -70
  25. data/manual/site/fonts/fontawesome-webfont.eot +0 -0
  26. data/manual/site/fonts/fontawesome-webfont.svg +2671 -0
  27. data/manual/site/fonts/fontawesome-webfont.ttf +0 -0
  28. data/manual/site/fonts/fontawesome-webfont.woff +0 -0
  29. data/manual/site/fonts/fontawesome-webfont.woff2 +0 -0
  30. data/manual/site/fonts/glyphicons-halflings-regular.eot +0 -0
  31. data/manual/site/fonts/glyphicons-halflings-regular.svg +288 -0
  32. data/manual/site/fonts/glyphicons-halflings-regular.ttf +0 -0
  33. data/manual/site/fonts/glyphicons-halflings-regular.woff +0 -0
  34. data/manual/site/fonts/glyphicons-halflings-regular.woff2 +0 -0
  35. data/manual/site/img/favicon.ico +0 -0
  36. data/manual/site/img/grid.png +0 -0
  37. data/manual/site/index.html +135 -396
  38. data/manual/site/js/base.js +216 -0
  39. data/manual/site/js/bootstrap-3.0.3.min.js +7 -0
  40. data/manual/site/js/jquery-1.10.2.min.js +6 -0
  41. data/manual/site/js/jquery.nicescroll.min.js +0 -0
  42. data/manual/site/js/jquery.pageslide.min.js +0 -0
  43. data/manual/site/js/parallaxImg.js +0 -0
  44. data/manual/site/machinery-analyze.1/index.html +25 -54
  45. data/manual/site/machinery-build.1/index.html +25 -85
  46. data/manual/site/machinery-compare.1/index.html +25 -87
  47. data/manual/site/machinery-config.1/index.html +25 -62
  48. data/manual/site/machinery-copy.1/index.html +25 -50
  49. data/manual/site/machinery-deploy.1/index.html +25 -87
  50. data/manual/site/machinery-export-autoyast.1/index.html +25 -74
  51. data/manual/site/machinery-export-html.1/index.html +25 -55
  52. data/manual/site/machinery-export-kiwi.1/index.html +25 -56
  53. data/manual/site/machinery-inspect-container.1/index.html +25 -129
  54. data/manual/site/machinery-inspect.1/index.html +25 -172
  55. data/manual/site/machinery-list.1/index.html +25 -67
  56. data/manual/site/machinery-man.1/index.html +25 -34
  57. data/manual/site/machinery-move.1/index.html +25 -49
  58. data/manual/site/machinery-remove.1/index.html +25 -62
  59. data/manual/site/machinery-serve.1/index.html +25 -61
  60. data/manual/site/machinery-show.1/index.html +25 -86
  61. data/manual/site/machinery-upgrade-format.1/index.html +25 -60
  62. data/manual/site/machinery-validate.1/index.html +25 -48
  63. data/manual/site/machinery.ymp +10 -10
  64. data/manual/site/machinery_main_general.1/index.html +25 -133
  65. data/manual/site/machinery_main_scopes.1/index.html +25 -129
  66. data/manual/site/machinery_main_security_implications.1/index.html +25 -108
  67. data/manual/site/machinery_main_usecases.1/index.html +25 -44
  68. data/manual/site/search/lunr.js +2986 -0
  69. data/manual/site/search/main.js +96 -0
  70. data/manual/site/search/search_index.json +1 -0
  71. data/manual/site/search/worker.js +128 -0
  72. data/manual/site/sitemap.xml +48 -87
  73. data/manual/site/sitemap.xml.gz +0 -0
  74. data/plugins/os/os_model.rb +0 -29
  75. data/tools/go.rb +14 -20
  76. metadata +32 -17
  77. data/manual/site/mkdocs/js/lunr.min.js +0 -7
  78. data/manual/site/mkdocs/js/mustache.min.js +0 -1
  79. data/manual/site/mkdocs/js/require.js +0 -36
  80. data/manual/site/mkdocs/js/search-results-template.mustache +0 -4
  81. data/manual/site/mkdocs/js/search.js +0 -88
  82. data/manual/site/mkdocs/js/text.js +0 -390
  83. data/manual/site/mkdocs/search_index.json +0 -869
data/manual/site/machinery-upgrade-format.1/index.html CHANGED
@@ -17,35 +17,35 @@
17
17
 
18
18
 
19
19
  <li class="">
20
- <a href="../docs/">Welcome</a>
20
+ <a href="docs/">Welcome</a>
21
21
  </li>
22
22
 
23
23
 
24
24
 
25
25
 
26
26
  <li class="">
27
- <a href="../machinery_main_general.1/">General Overview</a>
27
+ <a href="machinery_main_general.1/">General Overview</a>
28
28
  </li>
29
29
 
30
30
 
31
31
 
32
32
 
33
33
  <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
34
+ <a href="machinery_main_scopes.1/">Scopes</a>
35
35
  </li>
36
36
 
37
37
 
38
38
 
39
39
 
40
40
  <li class="">
41
- <a href="../machinery_main_usecases.1/">Use cases</a>
41
+ <a href="machinery_main_usecases.1/">Use cases</a>
42
42
  </li>
43
43
 
44
44
 
45
45
 
46
46
 
47
47
  <li class="">
48
- <a href="../machinery_main_security_implications.1/">Security Implications</a>
48
+ <a href="machinery_main_security_implications.1/">Security Implications</a>
49
49
  </li>
50
50
 
51
51
 
@@ -55,79 +55,79 @@
55
55
  <ul>
56
56
 
57
57
  <li class="">
58
- <a href="../machinery-analyze.1/">Analyze</a>
58
+ <a href="machinery-analyze.1/">Analyze</a>
59
59
  </li>
60
60
 
61
61
  <li class="">
62
- <a href="../machinery-build.1/">Build</a>
62
+ <a href="machinery-build.1/">Build</a>
63
63
  </li>
64
64
 
65
65
  <li class="">
66
- <a href="../machinery-compare.1/">Compare</a>
66
+ <a href="machinery-compare.1/">Compare</a>
67
67
  </li>
68
68
 
69
69
  <li class="">
70
- <a href="../machinery-config.1/">Config</a>
70
+ <a href="machinery-config.1/">Config</a>
71
71
  </li>
72
72
 
73
73
  <li class="">
74
- <a href="../machinery-copy.1/">Copy</a>
74
+ <a href="machinery-copy.1/">Copy</a>
75
75
  </li>
76
76
 
77
77
  <li class="">
78
- <a href="../machinery-deploy.1/">Deploy</a>
78
+ <a href="machinery-deploy.1/">Deploy</a>
79
79
  </li>
80
80
 
81
81
  <li class="">
82
- <a href="../machinery-export-autoyast.1/">Export AutoYaST</a>
82
+ <a href="machinery-export-autoyast.1/">Export AutoYaST</a>
83
83
  </li>
84
84
 
85
85
  <li class="">
86
- <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
86
+ <a href="machinery-export-kiwi.1/">Export Kiwi</a>
87
87
  </li>
88
88
 
89
89
  <li class="">
90
- <a href="../machinery-export-html.1/">Export HTML</a>
90
+ <a href="machinery-export-html.1/">Export HTML</a>
91
91
  </li>
92
92
 
93
93
  <li class="">
94
- <a href="../machinery-inspect.1/">Inspect</a>
94
+ <a href="machinery-inspect.1/">Inspect</a>
95
95
  </li>
96
96
 
97
97
  <li class="">
98
- <a href="../machinery-inspect-container.1/">Inspect Container</a>
98
+ <a href="machinery-inspect-container.1/">Inspect Container</a>
99
99
  </li>
100
100
 
101
101
  <li class="">
102
- <a href="../machinery-list.1/">List</a>
102
+ <a href="machinery-list.1/">List</a>
103
103
  </li>
104
104
 
105
105
  <li class="">
106
- <a href="../machinery-man.1/">Man</a>
106
+ <a href="machinery-man.1/">Man</a>
107
107
  </li>
108
108
 
109
109
  <li class="">
110
- <a href="../machinery-move.1/">Move</a>
110
+ <a href="machinery-move.1/">Move</a>
111
111
  </li>
112
112
 
113
113
  <li class="">
114
- <a href="../machinery-remove.1/">Remove</a>
114
+ <a href="machinery-remove.1/">Remove</a>
115
115
  </li>
116
116
 
117
117
  <li class="">
118
- <a href="../machinery-serve.1/">Serve</a>
118
+ <a href="machinery-serve.1/">Serve</a>
119
119
  </li>
120
120
 
121
121
  <li class="">
122
- <a href="../machinery-show.1/">Show</a>
122
+ <a href="machinery-show.1/">Show</a>
123
123
  </li>
124
124
 
125
125
  <li class="current">
126
- <a href="./">Upgrade Format</a>
126
+ <a href="machinery-upgrade-format.1/">Upgrade Format</a>
127
127
  </li>
128
128
 
129
129
  <li class="">
130
- <a href="../machinery-validate.1/">Validate</a>
130
+ <a href="machinery-validate.1/">Validate</a>
131
131
  </li>
132
132
 
133
133
  </ul>
@@ -138,42 +138,7 @@
138
138
  </ul>
139
139
  </div>
140
140
  <div class="content">
141
- <h1 id="upgrade-format-upgrade-system-description">upgrade-format — Upgrade System Description</h1>
142
- <h2 id="synopsis">Synopsis</h2>
143
- <p><code>machinery upgrade-format</code> --all</p>
144
- <p><code>machinery upgrade-format</code> NAME</p>
145
- <p><code>machinery</code> help upgrade-format</p>
146
- <h2 id="description">Description</h2>
147
- <p>The <code>upgrade-format</code> command upgrades a system description to the latest format
148
- version.</p>
149
- <p>The <code>format</code> in this context is the structure of the internal system description
150
- data. If the format version of a system description does not match the current
151
- <code>machinery</code> format version, <code>machinery</code> is no longer able to work with the data
152
- until it is upgraded. The current format version can be retrieved using
153
- <code>machinery --version</code>. The format version of a system description can be found
154
- in the <code>meta</code> section of the according <code>manifest.json</code> file.</p>
155
- <p>If the <code>--all</code> switch is given all local descriptions will be upgraded.</p>
156
- <h2 id="options">Options</h2>
157
- <ul>
158
- <li><code>--all</code> (optional):
159
- Upgrade all stored system descriptions.</li>
160
- </ul>
161
- <h2 id="arguments">Arguments</h2>
162
- <ul>
163
- <li><code>NAME</code> (optional):
164
- Upgrade specified system description.</li>
165
- </ul>
166
- <h2 id="examples">Examples</h2>
167
- <ul>
168
- <li>
169
- <p>Upgrade the system description stored as <code>earth</code>:</p>
170
- <p>$ <code>machinery</code> upgrade-format earth</p>
171
- </li>
172
- <li>
173
- <p>Upgrade all stored system descriptions:</p>
174
- <p>$ <code>machinery</code> upgrade-format --all</p>
175
- </li>
176
- </ul>
141
+
177
142
  </div>
178
143
  </div>
179
144
  </body>
data/manual/site/machinery-validate.1/index.html CHANGED
@@ -17,35 +17,35 @@
17
17
 
18
18
 
19
19
  <li class="">
20
- <a href="../docs/">Welcome</a>
20
+ <a href="docs/">Welcome</a>
21
21
  </li>
22
22
 
23
23
 
24
24
 
25
25
 
26
26
  <li class="">
27
- <a href="../machinery_main_general.1/">General Overview</a>
27
+ <a href="machinery_main_general.1/">General Overview</a>
28
28
  </li>
29
29
 
30
30
 
31
31
 
32
32
 
33
33
  <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
34
+ <a href="machinery_main_scopes.1/">Scopes</a>
35
35
  </li>
36
36
 
37
37
 
38
38
 
39
39
 
40
40
  <li class="">
41
- <a href="../machinery_main_usecases.1/">Use cases</a>
41
+ <a href="machinery_main_usecases.1/">Use cases</a>
42
42
  </li>
43
43
 
44
44
 
45
45
 
46
46
 
47
47
  <li class="">
48
- <a href="../machinery_main_security_implications.1/">Security Implications</a>
48
+ <a href="machinery_main_security_implications.1/">Security Implications</a>
49
49
  </li>
50
50
 
51
51
 
@@ -55,79 +55,79 @@
55
55
  <ul>
56
56
 
57
57
  <li class="">
58
- <a href="../machinery-analyze.1/">Analyze</a>
58
+ <a href="machinery-analyze.1/">Analyze</a>
59
59
  </li>
60
60
 
61
61
  <li class="">
62
- <a href="../machinery-build.1/">Build</a>
62
+ <a href="machinery-build.1/">Build</a>
63
63
  </li>
64
64
 
65
65
  <li class="">
66
- <a href="../machinery-compare.1/">Compare</a>
66
+ <a href="machinery-compare.1/">Compare</a>
67
67
  </li>
68
68
 
69
69
  <li class="">
70
- <a href="../machinery-config.1/">Config</a>
70
+ <a href="machinery-config.1/">Config</a>
71
71
  </li>
72
72
 
73
73
  <li class="">
74
- <a href="../machinery-copy.1/">Copy</a>
74
+ <a href="machinery-copy.1/">Copy</a>
75
75
  </li>
76
76
 
77
77
  <li class="">
78
- <a href="../machinery-deploy.1/">Deploy</a>
78
+ <a href="machinery-deploy.1/">Deploy</a>
79
79
  </li>
80
80
 
81
81
  <li class="">
82
- <a href="../machinery-export-autoyast.1/">Export AutoYaST</a>
82
+ <a href="machinery-export-autoyast.1/">Export AutoYaST</a>
83
83
  </li>
84
84
 
85
85
  <li class="">
86
- <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
86
+ <a href="machinery-export-kiwi.1/">Export Kiwi</a>
87
87
  </li>
88
88
 
89
89
  <li class="">
90
- <a href="../machinery-export-html.1/">Export HTML</a>
90
+ <a href="machinery-export-html.1/">Export HTML</a>
91
91
  </li>
92
92
 
93
93
  <li class="">
94
- <a href="../machinery-inspect.1/">Inspect</a>
94
+ <a href="machinery-inspect.1/">Inspect</a>
95
95
  </li>
96
96
 
97
97
  <li class="">
98
- <a href="../machinery-inspect-container.1/">Inspect Container</a>
98
+ <a href="machinery-inspect-container.1/">Inspect Container</a>
99
99
  </li>
100
100
 
101
101
  <li class="">
102
- <a href="../machinery-list.1/">List</a>
102
+ <a href="machinery-list.1/">List</a>
103
103
  </li>
104
104
 
105
105
  <li class="">
106
- <a href="../machinery-man.1/">Man</a>
106
+ <a href="machinery-man.1/">Man</a>
107
107
  </li>
108
108
 
109
109
  <li class="">
110
- <a href="../machinery-move.1/">Move</a>
110
+ <a href="machinery-move.1/">Move</a>
111
111
  </li>
112
112
 
113
113
  <li class="">
114
- <a href="../machinery-remove.1/">Remove</a>
114
+ <a href="machinery-remove.1/">Remove</a>
115
115
  </li>
116
116
 
117
117
  <li class="">
118
- <a href="../machinery-serve.1/">Serve</a>
118
+ <a href="machinery-serve.1/">Serve</a>
119
119
  </li>
120
120
 
121
121
  <li class="">
122
- <a href="../machinery-show.1/">Show</a>
122
+ <a href="machinery-show.1/">Show</a>
123
123
  </li>
124
124
 
125
125
  <li class="">
126
- <a href="../machinery-upgrade-format.1/">Upgrade Format</a>
126
+ <a href="machinery-upgrade-format.1/">Upgrade Format</a>
127
127
  </li>
128
128
 
129
129
  <li class="current">
130
- <a href="./">Validate</a>
130
+ <a href="machinery-validate.1/">Validate</a>
131
131
  </li>
132
132
 
133
133
  </ul>
@@ -138,30 +138,7 @@
138
138
  </ul>
139
139
  </div>
140
140
  <div class="content">
141
- <h1 id="validate-validate-system-description">validate — Validate System Description</h1>
142
- <h2 id="synopsis">Synopsis</h2>
143
- <p><code>machinery validate</code> NAME</p>
144
- <p><code>machinery</code> help validate</p>
145
- <h2 id="description">Description</h2>
146
- <p>The <code>validate</code> subcommand validates an existing system description.
147
- It checks, that the description has the correct structure and the data stored
148
- there conforms to the required schema. It also verifies that all extracted files
149
- are present on disk and that all files have meta information.</p>
150
- <p>In case of issues errors are shown with additional information.</p>
151
- <p>The main purpose of this command is to verify the system description after
152
- manually editing it.</p>
153
- <h2 id="arguments">Arguments</h2>
154
- <ul>
155
- <li><code>NAME</code> (required):
156
- Name of the system description.</li>
157
- </ul>
158
- <h2 id="examples">Examples</h2>
159
- <ul>
160
- <li>
161
- <p>Validate the system description with the name <code>myhost</code>:</p>
162
- <p>$ <code>machinery</code> validate myhost</p>
163
- </li>
164
- </ul>
141
+
165
142
  </div>
166
143
  </div>
167
144
  </body>
data/manual/site/machinery.ymp CHANGED
@@ -1,13 +1,13 @@
1
1
  <metapackage xmlns:os="http://opensuse.org/Standards/One_Click_Install" xmlns="http://opensuse.org/Standards/One_Click_Install">
2
2
 
3
- <!-- openSUSE Leap 42.1 -->
4
- <group distversion="openSUSE Leap 42.1">
3
+ <!-- openSUSE Leap 15.1 -->
4
+ <group distversion="openSUSE Leap 15.1">
5
5
  <repositories>
6
6
  <repository recommended="false">
7
- <name>openSUSE Leap 42.1</name>
8
- <summary>Test setup for openSUSE Leap 42.1</summary>
7
+ <name>openSUSE Leap 15.1</name>
8
+ <summary>Test setup for openSUSE Leap 15.1</summary>
9
9
  <description></description>
10
- <url>http://download.opensuse.org/distribution/leap/42.1/repo/oss/</url>
10
+ <url>http://download.opensuse.org/distribution/leap/15.1/repo/oss/</url>
11
11
  </repository>
12
12
  </repositories>
13
13
  <software>
@@ -21,14 +21,14 @@ universal system description.</description>
21
21
  </software>
22
22
  </group>
23
23
 
24
- <!-- openSUSE Leap 42.2 -->
25
- <group distversion="openSUSE Leap 42.2">
24
+ <!-- openSUSE Leap 15.0 -->
25
+ <group distversion="openSUSE Leap 15.0">
26
26
  <repositories>
27
27
  <repository recommended="false">
28
- <name>openSUSE Leap 42.2</name>
29
- <summary>Test setup for openSUSE Leap 42.2</summary>
28
+ <name>openSUSE Leap 15.0</name>
29
+ <summary>Test setup for openSUSE Leap 15.0</summary>
30
30
  <description></description>
31
- <url>http://download.opensuse.org/distribution/leap/42.2/repo/oss/</url>
31
+ <url>http://download.opensuse.org/distribution/leap/15.0/repo/oss/</url>
32
32
  </repository>
33
33
  </repositories>
34
34
  <software>
data/manual/site/machinery_main_general.1/index.html CHANGED
@@ -17,35 +17,35 @@
17
17
 
18
18
 
19
19
  <li class="">
20
- <a href="../docs/">Welcome</a>
20
+ <a href="docs/">Welcome</a>
21
21
  </li>
22
22
 
23
23
 
24
24
 
25
25
 
26
26
  <li class="current">
27
- <a href="./">General Overview</a>
27
+ <a href="machinery_main_general.1/">General Overview</a>
28
28
  </li>
29
29
 
30
30
 
31
31
 
32
32
 
33
33
  <li class="">
34
- <a href="../machinery_main_scopes.1/">Scopes</a>
34
+ <a href="machinery_main_scopes.1/">Scopes</a>
35
35
  </li>
36
36
 
37
37
 
38
38
 
39
39
 
40
40
  <li class="">
41
- <a href="../machinery_main_usecases.1/">Use cases</a>
41
+ <a href="machinery_main_usecases.1/">Use cases</a>
42
42
  </li>
43
43
 
44
44
 
45
45
 
46
46
 
47
47
  <li class="">
48
- <a href="../machinery_main_security_implications.1/">Security Implications</a>
48
+ <a href="machinery_main_security_implications.1/">Security Implications</a>
49
49
  </li>
50
50
 
51
51
 
@@ -55,79 +55,79 @@
55
55
  <ul>
56
56
 
57
57
  <li class="">
58
- <a href="../machinery-analyze.1/">Analyze</a>
58
+ <a href="machinery-analyze.1/">Analyze</a>
59
59
  </li>
60
60
 
61
61
  <li class="">
62
- <a href="../machinery-build.1/">Build</a>
62
+ <a href="machinery-build.1/">Build</a>
63
63
  </li>
64
64
 
65
65
  <li class="">
66
- <a href="../machinery-compare.1/">Compare</a>
66
+ <a href="machinery-compare.1/">Compare</a>
67
67
  </li>
68
68
 
69
69
  <li class="">
70
- <a href="../machinery-config.1/">Config</a>
70
+ <a href="machinery-config.1/">Config</a>
71
71
  </li>
72
72
 
73
73
  <li class="">
74
- <a href="../machinery-copy.1/">Copy</a>
74
+ <a href="machinery-copy.1/">Copy</a>
75
75
  </li>
76
76
 
77
77
  <li class="">
78
- <a href="../machinery-deploy.1/">Deploy</a>
78
+ <a href="machinery-deploy.1/">Deploy</a>
79
79
  </li>
80
80
 
81
81
  <li class="">
82
- <a href="../machinery-export-autoyast.1/">Export AutoYaST</a>
82
+ <a href="machinery-export-autoyast.1/">Export AutoYaST</a>
83
83
  </li>
84
84
 
85
85
  <li class="">
86
- <a href="../machinery-export-kiwi.1/">Export Kiwi</a>
86
+ <a href="machinery-export-kiwi.1/">Export Kiwi</a>
87
87
  </li>
88
88
 
89
89
  <li class="">
90
- <a href="../machinery-export-html.1/">Export HTML</a>
90
+ <a href="machinery-export-html.1/">Export HTML</a>
91
91
  </li>
92
92
 
93
93
  <li class="">
94
- <a href="../machinery-inspect.1/">Inspect</a>
94
+ <a href="machinery-inspect.1/">Inspect</a>
95
95
  </li>
96
96
 
97
97
  <li class="">
98
- <a href="../machinery-inspect-container.1/">Inspect Container</a>
98
+ <a href="machinery-inspect-container.1/">Inspect Container</a>
99
99
  </li>
100
100
 
101
101
  <li class="">
102
- <a href="../machinery-list.1/">List</a>
102
+ <a href="machinery-list.1/">List</a>
103
103
  </li>
104
104
 
105
105
  <li class="">
106
- <a href="../machinery-man.1/">Man</a>
106
+ <a href="machinery-man.1/">Man</a>
107
107
  </li>
108
108
 
109
109
  <li class="">
110
- <a href="../machinery-move.1/">Move</a>
110
+ <a href="machinery-move.1/">Move</a>
111
111
  </li>
112
112
 
113
113
  <li class="">
114
- <a href="../machinery-remove.1/">Remove</a>
114
+ <a href="machinery-remove.1/">Remove</a>
115
115
  </li>
116
116
 
117
117
  <li class="">
118
- <a href="../machinery-serve.1/">Serve</a>
118
+ <a href="machinery-serve.1/">Serve</a>
119
119
  </li>
120
120
 
121
121
  <li class="">
122
- <a href="../machinery-show.1/">Show</a>
122
+ <a href="machinery-show.1/">Show</a>
123
123
  </li>
124
124
 
125
125
  <li class="">
126
- <a href="../machinery-upgrade-format.1/">Upgrade Format</a>
126
+ <a href="machinery-upgrade-format.1/">Upgrade Format</a>
127
127
  </li>
128
128
 
129
129
  <li class="">
130
- <a href="../machinery-validate.1/">Validate</a>
130
+ <a href="machinery-validate.1/">Validate</a>
131
131
  </li>
132
132
 
133
133
  </ul>
@@ -138,115 +138,7 @@
138
138
  </ul>
139
139
  </div>
140
140
  <div class="content">
141
- <h1 id="machinery-a-systems-management-toolkit-for-linux">Machinery — A Systems Management Toolkit for Linux</h1>
142
- <h1 id="synopsis">Synopsis</h1>
143
- <p><code>machinery</code> SUBCOMMAND [options] <br>
144
- <code>machinery</code> help [SUBCOMMAND]</p>
145
- <h1 id="conceptual-overview">Conceptual Overview</h1>
146
- <p>Machinery's core concept is the complete representation of a system by a
147
- universal system description.
148
- System descriptions are managed independently of the described
149
- systems which allows for system state conservation and offline preparation of
150
- modifications.</p>
151
- <p>Machinery's subcommands work on the system description as the connecting
152
- element.
153
- System descriptions are obtained by inspecting systems, importing from other
154
- formats, manual creation or merging existing descriptions.
155
- Machinery can store and modify system descriptions to allow changes to
156
- described state of the system.
157
- System descriptions can be compared to find similarities and differences
158
- between them or analyzed to deepen the knowledge about particular aspects of
159
- the system.
160
- System descriptions may be exported to other formats and can be used to
161
- migrate or replicate systems.</p>
162
- <p>Subcommands can be combined in different ways to accommodate higher-level work
163
- flows and use cases.
164
- These are some implemented and planned use cases:</p>
165
- <p>Migrate a physical system to a virtual environment:</p>
166
- <ul>
167
- <li>Inspect a system to obtain a system description</li>
168
- <li>Export the system description to a Kiwi configuration</li>
169
- <li>Build a cloud image from the configuration</li>
170
- <li>Deploy the image to the cloud</li>
171
- </ul>
172
- <p>Migrate a system while changing the configuration:</p>
173
- <ul>
174
- <li>Inspect a system to obtain a system description</li>
175
- <li>Modify the system description</li>
176
- <li>Build image for deployment</li>
177
- </ul>
178
- <p>Using Machinery as an extension from other formats:</p>
179
- <ul>
180
- <li>Import AutoYaST profile as system description</li>
181
- <li>Build image for deployment</li>
182
- </ul>
183
- <p>Machinery provides an extensible set of tools which can be combined to create
184
- higher-level work flows.
185
- It is designed for environments which focus on automation, integration
186
- of diverse tools and accountable management.
187
- Machinery integrates with existing configuration management solutions to
188
- address use cases currently not covered by them.</p>
189
- <h2 id="the-machinery-command">The machinery Command</h2>
190
- <p>Machinery is implemented as a command line tool named <code>machinery</code>. The
191
- <code>machinery</code> command has several subcommands for specific tasks. All
192
- subcommands work with the same system description identified by an optional
193
- name which can be used by all subcommands.</p>
194
- <h2 id="system-description">System Description</h2>
195
- <p>The System Description format and file structure is documented in the machinery
196
- wiki: <a href="https://github.com/SUSE/machinery/wiki/System-Description-Format">System Description Format</a>.</p>
197
- <p>Machinery validates descriptions on load. It checks that the JSON structure of
198
- the manifest file, which contains the primary and meta data of a description, is
199
- correct and it adheres to the schema. Validation errors are reported as warnings.
200
- It also checks that the information about extracted files is consistent. Missing
201
- files or extra files without reference in the manifest are treated also as
202
- warnings. All other issues are errors which need to be fixed so that Machinery
203
- can use the description.
204
- To manually validate a description use the <code>machinery validate</code> command.</p>
205
- <h2 id="scopes">Scopes</h2>
206
- <p>The system description is structured into "scopes". A scope covers a specific
207
- part of the configuration of the inspected system such as installed packages,
208
- repositories, or changed configuration files.</p>
209
- <p>For example, if you are only interested in the installed packages, limit the
210
- scope to <code>packages</code>. This will output only the requested information.</p>
211
- <p>See the <a href="../machinery_main_scopes.1/">Scopes documentation</a> for a list of all supported scopes.</p>
212
- <h1 id="options-for-all-subcommands">Options for All Subcommands</h1>
213
- <!--- These are 'global' options of machinery -->
214
-
215
- <ul>
216
- <li>
217
- <p><code>--version</code>:
218
- Displays version of <code>machinery</code> tool. Exit when done.</p>
219
- </li>
220
- <li>
221
- <p><code>--debug</code>:
222
- Enable debug mode. Machinery writes additional information into the log
223
- file which can be useful to track down problems.</p>
224
- </li>
225
- </ul>
226
- <h1 id="files-and-devices">Files and Devices</h1>
227
- <ul>
228
- <li>
229
- <p><code>~/.machinery/machinery.config</code>:</p>
230
- <p>Configuration file.</p>
231
- </li>
232
- <li>
233
- <p><code>~/.machinery/machinery.log</code>:</p>
234
- <p>Central log file, in the format date, time, process id, and log message.</p>
235
- </li>
236
- <li>
237
- <p><code>em1 (openSUSE 13.2 / openSUSE leap)</code>, <code>eth0</code> (SLE11) and <code>lan0</code> (SLE12):</p>
238
- <p>First network device is used when DHCP in built image is enabled.</p>
239
- </li>
240
- </ul>
241
- <h1 id="environment">Environment</h1>
242
- <ul>
243
- <li>
244
- <p><code>MACHINERY_LOG_FILE</code>:</p>
245
- <p>Location of Machinery's log file (defaults to <code>~/.machinery/machinery.log</code>).</p>
246
- </li>
247
- </ul>
248
- <h1 id="copyright">Copyright</h1>
249
- <p>Copyright (c) 2013-2016 <a href="http://www.suse.com">SUSE LLC</a></p>
141
+
250
142
  </div>
251
143
  </div>
252
144
  </body>