capistrano-typo3 0.4.10 → 0.5.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.
@@ -11,6 +11,11 @@ require 'yaml' # Built in, no gem required
11
11
  TYPO3_DB_DUMP_DIR = 'db_dumps'
12
12
 
13
13
  load File.expand_path('../tasks/typo3.cap', __FILE__)
14
+ load File.expand_path('../tasks/typo3content.cap', __FILE__)
15
+ load File.expand_path('../tasks/typo3helper.cap', __FILE__)
16
+ load File.expand_path('../tasks/typo3homestead.cap', __FILE__)
17
+ load File.expand_path('../tasks/typo3test.cap', __FILE__)
18
+ load File.expand_path('../tasks/typo3vagrant.cap', __FILE__)
14
19
  load File.expand_path('../tasks/deploy.cap', __FILE__)
15
20
  load File.expand_path('../tasks/git.cap', __FILE__)
16
21
  load File.expand_path('../tasks/db.cap', __FILE__)
@@ -1,5 +1,5 @@
1
1
  module Capistrano
2
2
  module Typo3
3
- VERSION = "0.4.10"
3
+ VERSION = "0.5.1"
4
4
  end
5
5
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: capistrano-typo3
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.10
4
+ version: 0.5.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Pim Snel
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2018-10-02 00:00:00.000000000 Z
11
+ date: 2018-10-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: bundler
@@ -82,8 +82,6 @@ files:
82
82
  - README.md
83
83
  - Rakefile
84
84
  - capistrano-typo3.gemspec
85
- - docs/homestead_nl.md
86
- - docs/install_from_scratch.md
87
85
  - homestead_files/Vagrantfile
88
86
  - homestead_files/homestead.rb
89
87
  - homestead_files/vagrant.yml
@@ -91,6 +89,11 @@ files:
91
89
  - lib/capistrano/tasks/deploy.cap
92
90
  - lib/capistrano/tasks/git.cap
93
91
  - lib/capistrano/tasks/typo3.cap
92
+ - lib/capistrano/tasks/typo3content.cap
93
+ - lib/capistrano/tasks/typo3helper.cap
94
+ - lib/capistrano/tasks/typo3homestead.cap
95
+ - lib/capistrano/tasks/typo3test.cap
96
+ - lib/capistrano/tasks/typo3vagrant.cap
94
97
  - lib/capistrano/typo3.rb
95
98
  - lib/capistrano/typo3/dt3_div.rb
96
99
  - lib/capistrano/typo3/dt3_mysql.rb
data/docs/homestead_nl.md DELETED
@@ -1,164 +0,0 @@
1
- # Capistrano-typo3 + Homestead
2
-
3
- Als ontwikkelaar wil je in je eigen editor werken met de luxe dat je
4
- wel de volledige TYPO3 Lamp stack tot je beschikking hebt.
5
-
6
- Capistrano-typo3 integreert TYPO3.Homestead, een Vagrant machine van
7
- @tuurlijk die ervoor zorgt dat een website die geschikt is voor CI met
8
- Capistrano-typo3 ook heel makkelijk op een eigen machine geinstalleerd
9
- kan worden.
10
-
11
- TYPO3.Homestead bevat alle mogelijke hulpmiddelen voor TYPO3
12
- en PHP ontwikkelaars, waaronder diverse php-versies en php-debugging
13
- tools, maar ook o.a. MailHog, memcached, rabbitMQ, redis, elasticsearch.
14
- Capistrano-typo3 installeert homestead en houdt de configuratie helemaal
15
- vanilla. Lees alles over de mogelijkheden Homestead op de
16
- [TYPO3.Homestead gitlab site](https://github.com/Tuurlijk/TYPO3.Homestead).
17
-
18
- ## Installatie
19
-
20
- Als een site al geschikt is gemaakt voor Homestead moet je volgende
21
- handelingen uitvoeren in Homestead op je eigen machine met de website te
22
- installeren.
23
-
24
- ### 1. Clone de website en installeer de noodzakelijk gems
25
-
26
- ```
27
- git clone -b developer git@gitlab.lingewoud.net:sites/site-t3.git
28
- bundle install --path=vendor --binstubs
29
- ```
30
-
31
- ### 2. Draai het homestead setup script
32
-
33
- ```
34
- ./bin/cap homestead typo3:vagrant:setup_machine
35
- ```
36
-
37
- Als er iets niet goed gaat kun je met het volgende commando de machine
38
- verwijderen.
39
-
40
- ```
41
- ./bin/cap homestead typo3:vagrant:purge_machine
42
- ```
43
-
44
- Je kunt vervolgens weer met een schone lei het commando
45
-
46
- ```
47
- homestead:setup_machine
48
- ```
49
- uitvoeren.
50
-
51
- ### 3. Installeer de site in homestead
52
-
53
- ```
54
- ./bin/cap homestead typo3:vagrant:setup_site
55
- ```
56
-
57
- Als er iets niet goed gaat gebruik je het commando:
58
-
59
- ```
60
- ./bin/cap homestead typo3:vagrant:purge_site
61
- ```
62
-
63
- Je kunt vervolgens weer met een schone lei het volgende commando
64
- uitvoeren.
65
-
66
- ```
67
- ./bin/cap homestead typo3:vagrant:setup_site
68
- ```
69
-
70
- ### 4. Sychroniseer de live content bestanden
71
-
72
- Houdt er rekening mee dat dit lang kan duren. Voer het onderstaande
73
- commando uit om de bestanden vanuit de live installatie naar de vagrant
74
- machine de synchroniseren:
75
-
76
- ```
77
- ./bin/cap homestead typo3:content:sync_files_from_production
78
- ```
79
-
80
- ## Gebruiken
81
-
82
- ### Vagrant machine starten/stoppen
83
-
84
- Als Homestead geïnstalleerd is moet je de vagrant machine starten om met
85
- de site te kunnen werken.
86
-
87
- Open een terminal en cd naar de root directory van je TYPO3 project.
88
- Vanuit hier type je ```vagrant up```. Wil je de vagrant weer stoppen
89
- type dan ```vagrant halt```. Om te zien of vagrant draait type je
90
- ```vagrant status```.
91
-
92
- Let op: in de huidige versie van Capistrano-typo3+homestead mag er maar
93
- een vagrant machine tegelijk draaien.
94
-
95
- ### Site URL en broncode
96
-
97
- Als vagrant draait kun je website openen via: http://local.typo3.org.
98
-
99
- Als de website draait staat de TYPO3 code in de map
100
- ```[T3-project]/dummy```.
101
-
102
- ### Site database
103
-
104
- De database is te benaderen via een ssh-tunnel. Aan de hand van Sequel
105
- Pro leggen we uit hoe contact gemaakt kan worden met de database. Zie de
106
- schermafbeelding hieronder:
107
-
108
- ![image](http://picdrop.t3lab.com/xZDfFGGnQL.png)
109
-
110
- Maak een nieuwe profiel en vul de bestanden zoals hierboven. Het
111
- password veld van de database moet gevuld worden met ```supersecret```.
112
- De SSH Private is bij het maken van de machine gegenereerd. De ssh key
113
- staat in de verborgen map
114
- [T3-project]/.vagrant/machines/default/virtualbox/private_key
115
-
116
- Kopieer het volledige pad van de private key en plak deze in Sequel Pro.
117
-
118
- Als de vagrant machine draait geeft dit profiel toegang tot alle
119
- databases.
120
-
121
-
122
- ### Datase en evt bestanden synchroniseren
123
-
124
- Capistrano-typo3 gaat ervanuit dat database en de website content
125
- bestanden van de live website altijd de laatste versie is.
126
- Dit betekend dat op gezette momenten de ontwikkelaar de database en de
127
- bestanden in z'n Homestead ontwikkelomgeving wil bijwerken met de
128
- live versies. Dit kan met de volgende 2 losse commando's:
129
-
130
- ```
131
- ./bin/cap homestead typo3:content:sync_db_from_production
132
- ./bin/cap homestead typo3:content:sync_files_from_production
133
- ```
134
-
135
- ## Links
136
- - [TYPO3.Homestead](https://github.com/Tuurlijk/TYPO3.Homestead)
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
@@ -1,263 +0,0 @@
1
- # Nieuwe site
2
-
3
- Dit is een verslag van een from scratch installatie, dat moet leiden tot
4
- een complete handleiding.
5
-
6
- verslag TYPO3 omgeving maken voor development en release
7
-
8
- # TODO
9
-
10
- - Gemfile
11
- - Bundle install --bincaps
12
- - Capfile
13
- - Dir str.
14
- - testing
15
- - prelive
16
- - homestead conf
17
- - Dummy dir met typo3 vanilla
18
- - TYPO3 installatie
19
-
20
-
21
-
22
- ### Stap 1 gitrepogemaakt en gecloned om in te werken
23
-
24
- ### Stap 2 prelive omgeving
25
-
26
- Deze omgeving dient als content master zolang de website niet gereleased
27
- is. Om die reden maken we deze omgeving als eerste aan zodat de test en
28
- homestead omgeving gesynced kan worden met deze omgeving.
29
-
30
- - omgeving prelive op webserver met webpad,
31
-
32
- htdocroot =
33
-
34
- ```
35
- /var/customers/webs/userdev/point-prelive/current/dummy
36
- ```
37
-
38
- - database
39
-
40
- ### Stap 3
41
- in repo working copy
42
-
43
- vim Gemfile
44
-
45
- ```
46
- source 'https://rubygems.org'
47
- gem 'capistrano', '~> 3.5.0'
48
- gem 'capistrano-typo3', :git =>'https://github.com/mipmip/capistrano-typo3.git'
49
- ```
50
-
51
- ```
52
- bundle install --binstubs
53
- ```
54
-
55
- ```
56
- cap install STAGES=homestead,test,prelive,live
57
- ```
58
-
59
- Voeg toe aan Capfile
60
-
61
- ```
62
- require 'capistrano/typo3'
63
- ```
64
-
65
-
66
-
67
- ### Stap 4
68
-
69
- in repo working copy
70
-
71
- ```
72
- mkdir -p config/deploy/
73
- ```
74
-
75
- vim config/deploy/prelive.rb
76
-
77
- pas aan met instellingen zoals:
78
-
79
- ```
80
- server 'xxxxx.xxxxxx.net', roles: %w{web}, port: 22
81
-
82
- set :user, 'userxxx'
83
-
84
- set :deploy_to, "/var/www/#{fetch(:user)}/point-prelive"
85
- set :tmp_dir, "/var/www/#{fetch(:user)}/tmp"
86
- set :ssh_options, { user: fetch(:user) }
87
-
88
- set :stage, :prelive
89
- set :http_protocol, 'http'
90
- set :branch, "master"
91
- set :t3_dont_upgrade_source, 1
92
-
93
- set :main_domain_name, 'xxxxx.net'
94
-
95
- set :dbname, 'dbxxx'
96
- set :dbuser, 'userxxx'
97
- set :dbpass, 'xxxxxx'
98
- set :dbhost, 'localhost'
99
- ```
100
-
101
- and config/deploy.rb
102
-
103
- ```
104
- set :application, 'point-env001-t3'
105
-
106
- set :repo_url, 'git@gitlab.lingewoud.net:HS-TYPO3/point-env001-t3.git'
107
-
108
- set :scm, :git
109
- set :log_level, :debug
110
- set :keep_releases, 5
111
-
112
- set :domain_org, 'point-prelive.dev2.lingewoud.net'
113
-
114
- set :t3_main_version, '7.6'
115
- ```
116
-
117
- ### Stap 5, download typo3
118
-
119
- ```
120
- mkdir dummy
121
- cd dummy
122
- cd tar xzvf ~/Downloads/typo3_src-7.6.11.tar.gz
123
- ln -s typo3_src/index.php
124
- ln -s typo3_src/typo3
125
- cp typo3_src/_.htaccess .htaccess
126
- ```
127
-
128
- commit and push
129
-
130
-
131
- ### Stap 6, remote setup
132
-
133
- ```
134
- typo3:helper:rm_deploy_to
135
- deploy
136
- typo3:helper:setup_shared_typo3_dirs
137
- typo3:helper:current_relative_symlink
138
- first_install
139
- ```
140
-
141
-
142
- ### Stap 7, maak in de browser de installatie van prelive af
143
-
144
- Haal daarna dummy/typo3conf/ naar local for import in git
145
- ```
146
- rsync -av userdev@volkert.node.lingewoud.net:/var/customers/webs/userdev/point-prelive/current/dummy/typo3conf/ dummy/typo3conf/
147
- git add dummy
148
- git commit dummy
149
- git push
150
- ```
151
-
152
- ### Stap 8, maak test-env klaar
153
-
154
-
155
- maak configuratie van test in orde
156
-
157
- ```
158
-
159
- ```
160
-
161
- commit en push alles weg
162
-
163
- ```
164
- git checkout -b developer
165
- git push --set-upstream origin developer
166
- ```
167
-
168
- maak in deploy.rb de sync in orde
169
-
170
- ```
171
- set :t3_live_sync, -> do
172
- {
173
- 'filesync' => {
174
- 'fileadmin' => 'rsync -av xxxx@xxxx.net:/var/www/xxxx-prelive/shared/fileadmin/ shared/fileadmin/',
175
- 'uploads' => 'rsync -av xxxx@xxxx.net:/var/www/xxxx-prelive/shared/uploads/ shared/uploads/',
176
- },
177
- 'dbsync' => {
178
- 'ssh_server' => 'xxxx.net',
179
- 'ssh_user' => 'userdev',
180
- 'dbname' => 'xxxx',
181
- 'dbuser' => 'xxxx',
182
- 'dbpass' => 'xxxx',
183
- 'dbhost' => 'xxxx',
184
- },
185
- }
186
- end
187
-
188
- set :t3_sql_updates, -> do
189
- [
190
- # "UPDATE sys_template SET constants = REPLACE(constants, 'http://www.#{fetch(:domain_org)}/','http://#{fetch(:main_domain_name)}/') where uid=1",
191
- # "UPDATE sys_domain SET domainName = '#{fetch(:main_domain_name)}' WHERE uid = 1",
192
- # "DELETE FROM sys_domain WHERE uid = 1",
193
- ]
194
- end
195
- ```
196
-
197
-
198
- ### Stap 9 vagrant machine
199
-
200
- maak homestead conf.
201
-
202
- ```
203
- server 'localhost', roles: %w{web allow_syncfiles allow_syncdatabase}, port: 2222
204
- set :user, 'vagrant'
205
- set :stage, :homestead
206
- set :deploy_to, '/var'
207
- set :ssh_options, { user: 'vagrant', port: 2222, keys: ['.vagrant/machines/default/virtualbox/private_key'] }
208
- set :tmp_dir, "/tmp"
209
- set :bundle_executable, "/usr/local/bin/bundle"
210
- set :restart_webserver, "sudo service nginx restart"
211
-
212
- set :branch, "developer"
213
-
214
- set :git_no_cache, 1
215
-
216
- set :t3_store_db_credentials_in_addionalconf, 1
217
- set :t3_add_unsafe_trusted_host_pattern, 1
218
- set :t3_dont_upgrade_source, 1
219
-
220
- set :hs_default_upstream_php_engine, 'php56'
221
-
222
- set :main_domain_name, 'local.typo3.org'
223
- set :dbname, 'captypo3homestead'
224
- set :dbuser, 'root'
225
- set :dbpass, 'supersecret'
226
- set :dbhost, 'localhost'
227
-
228
- sync_ignore_items = [
229
- # '*.pdf'
230
- ]
231
- sync_ignore = ''
232
- sync_ignore_items.each do | ignore_item |
233
- sync_ignore << "--exclude '#{ignore_item}' "
234
- end
235
-
236
- set :t3_rsync_ignore, sync_ignore
237
- set :t3_protocol, "http"
238
- ```
239
-
240
-
241
- ### Stap 10 Setup machine
242
-
243
-
244
- installeer de juiste vagrant.yml en Vagrantfile
245
-
246
-
247
- ```
248
- ./bin/cap homestead typo3:vagrant:setup_machine
249
- ```
250
-
251
-
252
- ### Stap 20 Setup gitlab-ci.yml
253
-
254
- set key in variablen van gitlab
255
-
256
- keynaam: SSH_PRIVATE_KEY
257
- kay waarde: een key die met test en prelive ssh mag connecten
258
-
259
- ### Stap xxx Maak backend test gebruiker met nieuwe ww:
260
-
261
- automated_test web->page
262
-
263
- ### voeg minitest en watir toe