hetzner-bootstrap 1.0.2 → 2.0.0

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.
Files changed (17) hide show
  1. checksums.yaml +7 -0
  2. data/.rspec +2 -0
  3. data/.rubocop.yml +21 -0
  4. data/.ruby-version +1 -0
  5. data/Gemfile +3 -1
  6. data/LICENSE +1 -1
  7. data/README.md +116 -10
  8. data/Rakefile +2 -0
  9. data/example.rb +95 -96
  10. data/hetzner-bootstrap.gemspec +22 -16
  11. data/lib/hetzner-bootstrap.rb +23 -25
  12. data/lib/hetzner/bootstrap/target.rb +87 -86
  13. data/lib/hetzner/bootstrap/template.rb +7 -4
  14. data/lib/hetzner/bootstrap/version.rb +3 -1
  15. data/spec/hetzner_bootstrap_spec.rb +26 -31
  16. data/spec/spec_helper.rb +99 -0
  17. metadata +94 -52
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA256:
3
+ metadata.gz: d36bf429c8c67652f1e5887e8f99db50574d4cc8398ea718f634dc14acac31fb
4
+ data.tar.gz: df374d346e10b4af10624878a6dc0821dc30ecd106c84920fb44c449e1a3508c
5
+ SHA512:
6
+ metadata.gz: f1e5c12ee923b2798351be615267e4b76ba101fe21abf5f5ef3ef092b4a89e727ec864d051532d13b21de483c5b7c4e7f26771d9adbb0842b2e27cc5367b3bcb
7
+ data.tar.gz: 20724e0ec289640e9f40416de839f40cd8fba8a9d5eed81d42e3371afd4d856fc4fb4eb63630c5f25128c34d6c491c7dd4d2ced896acde379dc935300a72e8d9
data/.rspec ADDED
@@ -0,0 +1,2 @@
1
+ --color
2
+ --require spec_helper
data/.rubocop.yml ADDED
@@ -0,0 +1,21 @@
1
+ AllCops:
2
+ TargetRubyVersion: 3.0
3
+ NewCops: enable
4
+
5
+ Layout/LineLength:
6
+ Enabled: false
7
+
8
+ Metrics/MethodLength:
9
+ Enabled: false
10
+
11
+ Naming/FileName:
12
+ Enabled: false
13
+
14
+ Style/Documentation:
15
+ Enabled: false
16
+
17
+ Metrics/ClassLength:
18
+ Enabled: false
19
+
20
+ Metrics/AbcSize:
21
+ Enabled: false
data/.ruby-version ADDED
@@ -0,0 +1 @@
1
+ 3.0.0
data/Gemfile CHANGED
@@ -1,4 +1,6 @@
1
- source "http://rubygems.org"
1
+ # frozen_string_literal: true
2
+
3
+ source 'https://rubygems.org'
2
4
 
3
5
  # Specify your gem's dependencies in hetzner.gemspec
4
6
  gemspec
data/LICENSE CHANGED
@@ -1,4 +1,4 @@
1
- Copyright (c) 2011 Moriz GmbH, Roland Moriz, http://moriz.de/
1
+ Copyright (c) 2019 Moriz GmbH, Roland Moriz, http://moriz.de/
2
2
 
3
3
  Permission is hereby granted, free of charge, to any person obtaining
4
4
  a copy of this software and associated documentation files (the
data/README.md CHANGED
@@ -3,6 +3,8 @@ hetzner-bootstrap
3
3
 
4
4
  hetzner-bootstrap allows you to bootstrap a provisioned EQ Server from hetzner.de
5
5
 
6
+ [![Gem Version](https://badge.fury.io/rb/hetzner-bootstrap.png)](http://badge.fury.io/rb/hetzner-bootstrap)
7
+
6
8
  What it does:
7
9
  -------------
8
10
 
@@ -38,6 +40,117 @@ Example:
38
40
 
39
41
  Warning: All existing data on the system will be lost!
40
42
 
43
+
44
+
45
+ ```ruby
46
+
47
+ #!/usr/bin/env ruby
48
+ require 'hetzner-bootstrap'
49
+
50
+ bs = Hetzner::Bootstrap.new(api: Hetzner::API.new(ENV['ROBOT_USER'], ENV['ROBOT_PASSWORD']))
51
+
52
+ template = <<EOT
53
+ # see https://github.com/hetzneronline/installimage/
54
+ DRIVE1 /dev/sda
55
+ DRIVE2 /dev/sdb
56
+
57
+ ## activate software RAID? < 0 | 1 >
58
+ SWRAID 1
59
+
60
+ ## Choose the level for the software RAID < 0 | 1 >
61
+ SWRAIDLEVEL 1
62
+
63
+ ## which bootloader should be used? < lilo | grub >
64
+ BOOTLOADER grub
65
+
66
+ HOSTNAME <%= hostname %>
67
+
68
+ ## PART <mountpoint/lvm> <filesystem/VG> <size in MB>
69
+ ##
70
+ ## * <mountpoint/lvm> mountpoint for this filesystem *OR* keyword 'lvm'
71
+ ## to use this PART as volume group (VG) for LVM
72
+ ## * <filesystem/VG> can be ext2, ext3, reiserfs, xfs, swap *OR* name
73
+ ## of the LVM volume group (VG), if this PART is a VG
74
+ ## * <size> you can use the keyword 'all' to assign all the
75
+ ## remaining space of the drive to the *last* partition.
76
+ ## you can use M/G/T for unit specification in MIB/GIB/TIB
77
+ ##
78
+ ## notes:
79
+ ## - extended partitions are created automatically
80
+ ## - '/boot' cannot be on a xfs filesystem!
81
+ ## - '/boot' cannot be on LVM!
82
+ ## - when using software RAID 0, you need a '/boot' partition
83
+
84
+ PART /boot ext3 1G
85
+ PART lvm host 75G
86
+ PART lvm guest all
87
+
88
+ #LV <VG> <name> <mount> <filesystem> <size>
89
+ LV host root / ext4 50G
90
+ LV host swap swap swap 5G
91
+
92
+
93
+ ## ========================
94
+ ## OPERATING SYSTEM IMAGE:
95
+ ## ========================
96
+
97
+ ## full path to the operating system image
98
+ ## supported image sources: local dir, ftp, http, nfs
99
+ ## supported image types: tar, tar.gz, tar.bz, tar.bz2, tgz, tbz
100
+ ## examples:
101
+ #
102
+ # local: /path/to/image/filename.tar.gz
103
+ # ftp: ftp://<user>:<password>@hostname/path/to/image/filename.tar.bz2
104
+ # http: http://<user>:<password>@hostname/path/to/image/filename.tbz
105
+ # https: https://<user>:<password>@hostname/path/to/image/filename.tbz
106
+ # nfs: hostname:/path/to/image/filename.tgz
107
+
108
+ # Default images provided by hetzner as of October 2014:
109
+ # Archlinux-2014-64-minmal.tar.gz
110
+ # CentOS-65-32-minimal.tar.gz
111
+ # CentOS-65-64-cpanel.tar.gz
112
+ # CentOS-65-64-minimal.tar.gz
113
+ # CentOS-70-64-minimal.tar.gz
114
+ # Debian-76-wheezy-32-minimal.tar.gz
115
+ # Debian-76-wheezy-64-LAMP.tar.gz
116
+ # Debian-76-wheezy-64-minimal.tar.gz
117
+ # openSUSE-131-64-minimal.tar.gz
118
+ # Ubuntu-1204-precise-64-minimal.tar.gz
119
+ # Ubuntu-1404-trusty-64-minimal.tar.gz
120
+
121
+
122
+ IMAGE /root/images/Ubuntu-1404-trusty-64-minimal.tar.gz
123
+
124
+ EOT
125
+
126
+ # the post_install hook is a great place to setup further software/system provisioning
127
+ #
128
+ post_install = <<EOT
129
+ # knife bootstrap <%= ip %> -N <%= hostname %> "role[base],role[kvm_host]"
130
+ EOT
131
+
132
+ bs << {
133
+ ip: '1.2.3.4',
134
+ template: template, # string will be parsed by erubis
135
+ hostname: 'server100.example.com', # will be used for setting the systems' hostname
136
+ public_keys: "~/.ssh/id_dsa.pub", # will be copied over to the freshly bootstrapped system
137
+ post_install: post_install # will be called locally at the end and can be used e.g. to run a chef bootstrap
138
+ }
139
+
140
+ bs << {
141
+ ip: '1.2.3.5',
142
+ template: template, # string will be parsed by erubis
143
+ hostname: 'server101.example.com', # will be used for setting the systems' hostname
144
+ public_keys: "~/.ssh/id_dsa.pub", # will be copied over to the freshly bootstrapped system
145
+ post_install: post_install # will be called locally at the end and can be used e.g. to run a chef bootstrap
146
+ }
147
+
148
+ ...
149
+ bs.bootstrap!
150
+
151
+
152
+ ```
153
+
41
154
  Installation:
42
155
  -------------
43
156
 
@@ -47,20 +160,13 @@ Warnings:
47
160
  ---------
48
161
 
49
162
  * All existing data on the system will be wiped on bootstrap!
50
- * This is not an official Hetzner AG project.
51
- * The gem and the author are not related to Hetzner AG!
163
+ * This is not an official Hetzner Online GmbH project.
164
+ * The gem and the author are not related to Hetzner Online GmbH !
52
165
 
53
166
  **Use at your very own risk. Satisfaction is NOT guaranteed.**
54
167
 
55
- Commercial Support available through:
56
- -------------------------------------
57
-
58
- [![Moriz GmbH](https://moriz.de/images/logo.png)](http://moriz.de/)
59
-
60
- [Moriz GmbH, München](http://moriz.de/)
61
-
62
168
 
63
169
  Copyright
64
170
  ---------
65
171
 
66
- Copyright (c) 2011 Moriz GmbH, Roland Moriz. See LICENSE file for details.
172
+ Copyright © 2019 [Roland Moriz](https://roland.io), [Moriz GmbH](https://moriz.de/)
data/Rakefile CHANGED
@@ -1,2 +1,4 @@
1
+ # frozen_string_literal: true
2
+
1
3
  require 'bundler'
2
4
  Bundler::GemHelper.install_tasks
data/example.rb CHANGED
@@ -1,6 +1,8 @@
1
1
  #!/usr/bin/env ruby
2
- require "rubygems"
3
- require "hetzner-bootstrap"
2
+ # frozen_string_literal: true
3
+
4
+ require 'rubygems'
5
+ require 'hetzner-bootstrap'
4
6
 
5
7
  # get your API login from Hetzner's customer panel at: https://robot.your-server.de/
6
8
  # assign env variables:
@@ -10,105 +12,102 @@ require "hetzner-bootstrap"
10
12
  # rbenv-tip: checkout rbenv-vars, it's awesome!
11
13
  # https://github.com/sstephenson/rbenv-vars/
12
14
 
13
- bs = Hetzner::Bootstrap.new :api => Hetzner::API.new(ENV['ROBOT_USER'], ENV['ROBOT_PASSWORD'])
15
+ bs = Hetzner::Bootstrap.new(api: Hetzner::API.new(
16
+ ENV['ROBOT_USER'],
17
+ ENV['ROBOT_PASSWORD']
18
+ ))
14
19
 
15
20
  # 2 disks, software raid 1, etc.
16
- template = <<EOT
17
- DRIVE1 /dev/sda
18
- DRIVE2 /dev/sdb
19
- FORMATDRIVE2 0
20
-
21
- ## ===============
22
- ## SOFTWARE RAID:
23
- ## ===============
24
-
25
- ## activate software RAID? < 0 | 1 >
26
- SWRAID 1
27
-
28
- ## Choose the level for the software RAID < 0 | 1 >
29
- SWRAIDLEVEL 1
30
-
31
- ## which bootloader should be used? < lilo | grub >
32
- BOOTLOADER grub
33
-
34
- HOSTNAME <%= hostname %>
35
-
36
- ## PART <mountpoint/lvm> <filesystem/VG> <size in MB>
37
- ##
38
- ## * <mountpoint/lvm> mountpoint for this filesystem *OR* keyword 'lvm'
39
- ## to use this PART as volume group (VG) for LVM
40
- ## * <filesystem/VG> can be ext2, ext3, reiserfs, xfs, swap *OR* name
41
- ## of the LVM volume group (VG), if this PART is a VG
42
- ## * <size> you can use the keyword 'all' to assign all the
43
- ## remaining space of the drive to the *last* partition.
44
- ## you can use M/G/T for unit specification in MIB/GIB/TIB
45
- ##
46
- ## notes:
47
- ## - extended partitions are created automatically
48
- ## - '/boot' cannot be on a xfs filesystem!
49
- ## - '/boot' cannot be on LVM!
50
- ## - when using software RAID 0, you need a '/boot' partition
51
-
52
- PART /boot ext2 1G
53
- PART lvm host 75G
54
- PART lvm guest all
55
-
56
- #LV <VG> <name> <mount> <filesystem> <size>
57
- LV host root / ext3 50G
58
- LV host swap swap swap 5G
59
-
60
-
61
- ## ========================
62
- ## OPERATING SYSTEM IMAGE:
63
- ## ========================
64
-
65
- ## full path to the operating system image
66
- ## supported image sources: local dir, ftp, http, nfs
67
- ## supported image types: tar, tar.gz, tar.bz, tar.bz2, tgz, tbz
68
- ## examples:
69
- #
70
- # local: /path/to/image/filename.tar.gz
71
- # ftp: ftp://<user>:<password>@hostname/path/to/image/filename.tar.bz2
72
- # http: http://<user>:<password>@hostname/path/to/image/filename.tbz
73
- # https: https://<user>:<password>@hostname/path/to/image/filename.tbz
74
- # nfs: hostname:/path/to/image/filename.tgz
75
-
76
- # Default images provided by hetzner as of August 2012:
77
- # CentOS-58-32-minimal.tar.gz
78
- # CentOS-58-64-minimal.tar.gz
79
- # CentOS-62-32-minimal.tar.gz
80
- # CentOS-62-64-cpanel.tar.gz
81
- # CentOS-62-64-minimal.tar.gz
82
- # CentOS-63-32-minimal.tar.gz
83
- # CentOS-63-64-cpanel.tar.gz
84
- # CentOS-63-64-minimal.tar.gz
85
- # Debian-60-squeeze-32-minimal.tar.gz
86
- # Debian-60-squeeze-64-LAMP.tar.gz
87
- # Debian-60-squeeze-64-minimal.tar.gz
88
- # openSUSE-121-32-minimal.tar.gz
89
- # openSUSE-121-64-minimal.tar.gz
90
- # Ubuntu-1004-lucid-32-minimal.tar.gz
91
- # Ubuntu-1004-lucid-64-minimal.tar.gz
92
- # Ubuntu-1204-precise-32-minimal.tar.gz
93
- # Ubuntu-1204-precise-64-minimal.tar.gz
94
-
95
-
96
- IMAGE /root/images/Ubuntu-1204-precise-64-minimal.tar.gz
97
-
98
- EOT
99
-
100
- # the post_install hook is a great place to setup further software/system provisioning
21
+ template = <<~END_OF_TEMPLATE
22
+ DRIVE1 /dev/sda
23
+ DRIVE2 /dev/sdb
24
+ FORMATDRIVE2 0
25
+
26
+ ## ===============
27
+ ## SOFTWARE RAID:
28
+ ## ===============
29
+
30
+ ## activate software RAID? < 0 | 1 >
31
+ SWRAID 1
32
+
33
+ ## Choose the level for the software RAID < 0 | 1 >
34
+ SWRAIDLEVEL 1
35
+
36
+ ## which bootloader should be used? < lilo | grub >
37
+ BOOTLOADER grub
38
+
39
+ HOSTNAME <%= hostname %>
40
+
41
+ ## PART <mountpoint/lvm> <filesystem/VG> <size in MB>
42
+ ##
43
+ ## * <mountpoint/lvm> mountpoint for this filesystem *OR* keyword 'lvm'
44
+ ## to use this PART as volume group (VG) for LVM
45
+ ## * <filesystem/VG> can be ext2, ext3, reiserfs, xfs, swap *OR* name
46
+ ## of the LVM volume group (VG), if this PART is a VG
47
+ ## * <size> you can use the keyword 'all' to assign all the
48
+ ## remaining space of the drive to the *last* partition.
49
+ ## you can use M/G/T for unit specification in MIB/GIB/TIB
50
+ ##
51
+ ## notes:
52
+ ## - extended partitions are created automatically
53
+ ## - '/boot' cannot be on a xfs filesystem!
54
+ ## - '/boot' cannot be on LVM!
55
+ ## - when using software RAID 0, you need a '/boot' partition
56
+
57
+ PART /boot ext2 1G
58
+ PART lvm host 75G
59
+ PART lvm guest all
60
+
61
+ #LV <VG> <name> <mount> <filesystem> <size>
62
+ LV host root / ext3 50G
63
+ LV host swap swap swap 5G
64
+
65
+
66
+ ## ========================
67
+ ## OPERATING SYSTEM IMAGE:
68
+ ## ========================
69
+
70
+ ## full path to the operating system image
71
+ ## supported image sources: local dir, ftp, http, nfs
72
+ ## supported image types: tar, tar.gz, tar.bz, tar.bz2, tgz, tbz
73
+ ## examples:
74
+ #
75
+ # local: /path/to/image/filename.tar.gz
76
+ # ftp: ftp://<user>:<password>@hostname/path/to/image/filename.tar.bz2
77
+ # http: http://<user>:<password>@hostname/path/to/image/filename.tbz
78
+ # https: https://<user>:<password>@hostname/path/to/image/filename.tbz
79
+ # nfs: hostname:/path/to/image/filename.tgz
80
+
81
+ # Default images provided by hetzner as of October 2014:
82
+ # Archlinux-2014-64-minmal.tar.gz
83
+ # CentOS-65-32-minimal.tar.gz
84
+ # CentOS-65-64-cpanel.tar.gz
85
+ # CentOS-65-64-minimal.tar.gz
86
+ # CentOS-70-64-minimal.tar.gz
87
+ # Debian-76-wheezy-32-minimal.tar.gz
88
+ # Debian-76-wheezy-64-LAMP.tar.gz
89
+ # Debian-76-wheezy-64-minimal.tar.gz
90
+ # openSUSE-131-64-minimal.tar.gz
91
+ # Ubuntu-1204-precise-64-minimal.tar.gz
92
+ # Ubuntu-1404-trusty-64-minimal.tar.gz
93
+
94
+
95
+ IMAGE /root/images/Ubuntu-1204-precise-64-minimal.tar.gz
96
+
97
+ END_OF_TEMPLATE
98
+
99
+ # the post_install hook is a great place to setup further
100
+ # software/system provisioning
101
101
  #
102
- post_install = <<EOT
102
+ post_install = <<END_OF_POST_INSTALL
103
103
  # knife bootstrap <%= ip %> -N <%= hostname %> "role[base],role[kvm_host]"
104
- EOT
104
+ END_OF_POST_INSTALL
105
105
 
106
106
  # duplicate entry for each system
107
- bs << { :ip => "1.2.3.4",
108
- :template => template, # string will be parsed by erubis
109
- :hostname => 'server100.example.com', # will be used for setting the systems' hostname
110
- :public_keys => "~/.ssh/id_dsa.pub", # will be copied over to the freshly bootstrapped system
111
- :post_install => post_install } # will be called locally at the end and can be used e.g. to run a chef bootstrap
107
+ bs << { ip: '1.2.3.4',
108
+ template: template, # string will be parsed by erubis
109
+ hostname: 'server100', # sets hostname
110
+ public_keys: '~/.ssh/id_dsa.pub', # will be copied to your system
111
+ post_install: post_install } # will be executed *locally* at the end
112
112
 
113
113
  bs.bootstrap!
114
-
data/hetzner-bootstrap.gemspec CHANGED
@@ -1,26 +1,32 @@
1
- # -*- encoding: utf-8 -*-
2
- $:.push File.expand_path("../lib", __FILE__)
3
- require "hetzner/bootstrap/version"
1
+ # frozen_string_literal: true
2
+
3
+ $LOAD_PATH.push File.expand_path('lib', __dir__)
4
+ require 'hetzner/bootstrap/version'
4
5
 
5
6
  Gem::Specification.new do |s|
6
- s.name = "hetzner-bootstrap"
7
+ s.name = 'hetzner-bootstrap'
7
8
  s.version = Hetzner::Bootstrap::VERSION
8
9
  s.platform = Gem::Platform::RUBY
9
- s.authors = ["Roland Moriz"]
10
- s.email = ["roland@moriz.de"]
11
- s.homepage = "http://moriz.de/opensource/hetzner-api"
12
- s.summary = %q{Easy bootstrapping of hetzner.de rootservers using hetzner-api}
13
- s.description = %q{Easy bootstrapping of hetzner.de rootservers using hetzner-api}
10
+ s.authors = ['Roland Moriz']
11
+ s.email = ['roland@moriz.de']
12
+ s.homepage = 'https://github.com/rmoriz/hetzner-bootstrap'
13
+ s.summary = 'Easy bootstrapping of hetzner.de rootservers using hetzner-api'
14
+ s.description = 'Easy bootstrapping of hetzner.de rootservers using hetzner-api'
14
15
 
15
- s.add_dependency 'hetzner-api', '>= 1.0.1'
16
- s.add_dependency 'net-ssh', '>= 2.1.0'
17
- s.add_dependency 'erubis', '>= 2.6.6'
16
+ s.required_ruby_version = '~> 3.0'
17
+ s.add_dependency 'erubis', '>= 2.7.0'
18
+ s.add_dependency 'hetzner-api', '>= 1.1.0'
19
+ s.add_dependency 'net-ssh', '~> 6.1'
20
+ s.add_dependency 'rexml'
18
21
 
19
- s.add_development_dependency "rspec", ">= 2.4.0"
20
- s.add_development_dependency "rake"
22
+ s.add_development_dependency 'rake'
23
+ s.add_development_dependency 'rspec', '~> 3.4.0'
24
+ s.add_development_dependency 'rubocop', '~> 1.10'
25
+ s.add_development_dependency 'rubocop-rake'
26
+ s.add_development_dependency 'rubocop-rspec'
21
27
 
22
28
  s.files = `git ls-files`.split("\n")
23
29
  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
24
- s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
25
- s.require_paths = ["lib"]
30
+ s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
31
+ s.require_paths = ['lib']
26
32
  end