capistrano-typo3 0.2.4 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d6ed1e6b1fa60b5410aaa0000426a2e81336015a
-  data.tar.gz: 857590c36346b2e069e4346262e9dc56cd842417
+  metadata.gz: 9f5d21a82827f9fc925651b3d05f252e390431e8
+  data.tar.gz: fef24dac51b3398a7b39f595499a012b181086fc
 SHA512:
-  metadata.gz: 7b6650eccfe71fcdfeaa4d232147a0116cd432ecca80bd19b9a8fe504d9aefa30fa66954f8e8ba77a8628187f2da6403405b6471643effed79f8ae35e33bd159
-  data.tar.gz: 9aaa7ac88842e061b8ea62dc43798e8e22e2fe33e1187ce6ce3d196cfdcc4ef145ef5ec5fc8a54970a3d5b4ea68a916a7520ba4319cd79f7dfeca446899bf48f
+  metadata.gz: 17fe9f0215d5bd82422ed5f92c718f1c83ad878295dd481c2d375c87dc0a824e7ee47393e288a4047e7f832f6b7a0d7df3c259b9d2fbff148600dbb7eb9b76ee
+  data.tar.gz: 113cfd2c2b54b8439c7bf6e32b82c3476797d7fd1cfaf31698bdc03519aa32d96e0ade1fda084a88ef3bb43753f916ed2a5c403d5f32f3dca085429973b8bd3e

data/.codeclimate.yml

@@ -0,0 +1,8 @@
+engines:
+  rubocop:
+    enabled: true
+  duplication:
+    enabled: true
+    config:
+      languages:
+      - ruby

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## capistrano-typo3 0.3.2
+- hotfix wrong additional path
+
+## capistrano-typo3 0.3.1
+- split mysql sync commands into sep. commands to prevent site locking
+- add trusted hosts to homestead
+
 ## capistrano-typo3 0.2.4 2015-03-09
 - add clear all cache task
 

data/README.md

@@ -1,19 +1,19 @@
-# Capistrano::Typo3 [![Code Climate](https://codeclimate.com/github/mipmip/capistrano-typo3/badges/gpa.svg)](https://codeclimate.com/github/mipmip/capistrano-typo3)
+# Capistrano::Typo3 [![Code Climate](https://codeclimate.com/github/t3labcom/capistrano-typo3/badges/gpa.svg)](https://codeclimate.com/github/t3labcom/capistrano-typo3) [![Issue Count](https://codeclimate.com/github/t3labcom/capistrano-typo3/badges/issue_count.svg)](https://codeclimate.com/github/t3labcom/capistrano-typo3)
+
+**Note: this plugin works only with Capistrano 3.** Please check the
+capistrano gem version you're using before installing this gem:
 
-**Note: this plugin works only with Capistrano 3.** Please check the capistrano
-gem version you're using before installing this gem:
 `$ bundle show | grep capistrano`
 
-Capistrano deployment tasks for TYPO3 CMS. Incl. TYPO3 versions 4.5.x ... 6.2.x.
+Capistrano deployment tasks for TYPO3 CMS
 
 ## Compatibility
 
 The versions below have been tested with capistrano-typo3
 
-* 4.5.x
-* 4.6.x
-* 4.7.x
 * 6.2.x
+* 7.x
+* 8.x
 
 ##  Configuration
 
@@ -32,13 +32,12 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
-
-    $ gem install capistrano-typo3
-
 ## Usage
 
-TODO: Write usage instructions here
+### TYPO3.Homestead
+
+Capistrano-typo3 integrates TYPO3.Homestead. Here's the [Dutch documentation](docs/homestead_nl.md)
+about this integrations. English version will follow soon.
 
 ## References / inspiration
 * https://github.com/programmerqeu/capistrano-typo3-cms

data/capistrano-typo3.gemspec

@@ -8,9 +8,9 @@ Gem::Specification.new do |spec|
   spec.version       = Capistrano::Typo3::VERSION
   spec.authors       = ["Pim Snel"]
   spec.email         = ["pim@lingewoud.nl"]
-  spec.summary       = %q{Capistrano 3 tasks for TYPO3 CMS}
-  spec.description   = %q{Capistrano 3 tasks for TYPO3 CMS. Incl. TYPO3 versions 4.5.x ... 6.2.x.}
-  spec.homepage      = "https://github.com/mipmip/capistrano-typo3"
+  spec.summary       = %q{Capistrano 3 tasks and CI for TYPO3}
+  spec.description   = %q{Capistrano 3 deployment and continious delivery tasks for TYPO3 versions 6.2+, 7.x, 8.x}
+  spec.homepage      = "https://github.com/t3labcom/capistrano-typo3"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0")

data/docs/homestead_nl.md

@@ -0,0 +1,164 @@
+# Capistrano-typo3 + Homestead
+
+Als ontwikkelaar wil je in je eigen editor werken met de luxe dat je
+wel de volledige TYPO3 Lamp stack tot je beschikking hebt.
+
+Capistrano-typo3 integreert TYPO3.Homestead, een Vagrant machine van
+@tuurlijk die ervoor zorgt dat een website die geschikt is voor CI met
+Capistrano-typo3 ook heel makkelijk op een eigen machine geinstalleerd
+kan worden.
+
+TYPO3.Homestead bevat alle mogelijke hulpmiddelen voor TYPO3
+en PHP ontwikkelaars, waaronder diverse php-versies en php-debugging
+tools, maar ook o.a. MailHog, memcached, rabbitMQ, redis, elasticsearch.
+Capistrano-typo3 installeert homestead en houdt de configuratie helemaal
+vanilla. Lees alles over de mogelijkheden Homestead op de
+[TYPO3.Homestead gitlab site](https://github.com/Tuurlijk/TYPO3.Homestead).
+
+## Installatie
+
+Als een site al geschikt is gemaakt voor Homestead moet je volgende
+handelingen uitvoeren in Homestead op je eigen machine met de website te
+installeren.
+
+### 1. Clone de website en installeer de noodzakelijk gems
+
+```
+git clone -b developer git@gitlab.lingewoud.net:sites/site-t3.git
+bundle install --path=vendor --binstubs
+```
+
+### 2. Draai het homestead setup script
+
+```
+./bin/cap homestead typo3:vagrant:setup_machine
+```
+
+Als er iets niet goed gaat kun je met het volgende commando de machine
+verwijderen.
+
+```
+./bin/cap homestead typo3:vagrant:purge_machine
+```
+
+Je kunt vervolgens weer met een schone lei het commando
+
+```
+homestead:setup_machine
+```
+uitvoeren.
+
+### 3. Installeer de site in homestead
+
+```
+./bin/cap homestead typo3:vagrant:setup_site
+```
+
+Als er iets niet goed gaat gebruik je het commando:
+
+```
+./bin/cap homestead typo3:vagrant:purge_site
+```
+
+Je kunt vervolgens weer met een schone lei het volgende commando
+uitvoeren.
+
+```
+./bin/cap homestead typo3:vagrant:setup_site
+```
+
+### 4. Sychroniseer de live content bestanden
+
+Houdt er rekening mee dat dit lang kan duren. Voer het onderstaande
+commando uit om de bestanden vanuit de live installatie naar de vagrant
+machine de synchroniseren:
+
+```
+./bin/cap homestead typo3:content:sync_files_from_production
+```
+
+## Gebruiken
+
+### Vagrant machine starten/stoppen
+
+Als Homestead geïnstalleerd is moet je de vagrant machine starten om met
+de site te kunnen werken.
+
+Open een terminal en cd naar de root directory van je TYPO3 project.
+Vanuit hier type je ```vagrant up```. Wil je de vagrant weer stoppen
+type dan ```vagrant halt```. Om te zien of vagrant draait type je
+```vagrant status```.
+
+Let op: in de huidige versie van Capistrano-typo3+homestead mag er maar
+een vagrant machine tegelijk draaien.
+
+### Site URL en broncode
+
+Als vagrant draait kun je website openen via: http://local.typo3.org.
+
+Als de website draait staat de TYPO3 code in de map
+```[T3-project]/dummy```.
+
+### Site database
+
+De database is te benaderen via een ssh-tunnel. Aan de hand van Sequel
+Pro leggen we uit hoe contact gemaakt kan worden met de database. Zie de
+schermafbeelding hieronder:
+
+![image](http://picdrop.t3lab.com/xZDfFGGnQL.png)
+
+Maak een nieuwe profiel en vul de bestanden zoals hierboven. Het
+password veld van de database moet gevuld worden met ```supersecret```.
+De SSH Private is bij het maken van de machine gegenereerd. De ssh key
+staat in de verborgen map
+[T3-project]/.vagrant/machines/default/virtualbox/private_key
+
+Kopieer het volledige pad van de private key en plak deze in Sequel Pro.
+
+Als de vagrant machine draait geeft dit profiel toegang tot alle
+databases.
+
+
+### Datase en evt bestanden synchroniseren
+
+Capistrano-typo3 gaat ervanuit dat database en de website content
+bestanden van de live website altijd de laatste versie is.
+Dit betekend dat op gezette momenten de ontwikkelaar de database en de
+bestanden in z'n Homestead ontwikkelomgeving wil bijwerken met de
+live versies. Dit kan met de volgende 2 losse commando's:
+
+```
+./bin/cap homestead typo3:content:sync_db_from_production
+./bin/cap homestead typo3:content:sync_files_from_production
+```
+
+## Links
+- [TYPO3.Homestead](https://github.com/Tuurlijk/TYPO3.Homestead)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

data/docs/install_from_scratch.md

@@ -0,0 +1,263 @@
+# Nieuwe site
+
+Dit is een verslag van een from scratch installatie, dat moet leiden tot
+een complete handleiding.
+
+verslag TYPO3 omgeving maken voor development en release
+
+# TODO
+
+- Gemfile
+- Bundle install --bincaps
+- Capfile
+- Dir str.
+- testing
+- prelive
+- homestead conf
+- Dummy dir met typo3 vanilla
+- TYPO3 installatie
+
+
+
+### Stap 1 gitrepogemaakt en gecloned om in te werken
+
+### Stap 2 prelive omgeving
+
+Deze omgeving dient als content master zolang de website niet gereleased
+is. Om die reden maken we deze omgeving als eerste aan zodat de test en
+homestead omgeving gesynced kan worden met deze omgeving.
+
+- omgeving prelive op webserver met webpad,
+
+htdocroot =
+
+```
+/var/customers/webs/userdev/point-prelive/current/dummy
+```
+
+- database
+
+### Stap 3
+in repo working copy
+
+vim Gemfile
+
+```
+source 'https://rubygems.org'
+gem 'capistrano', '~> 3.5.0'
+gem 'capistrano-typo3', :git =>'https://github.com/mipmip/capistrano-typo3.git'
+```
+
+```
+bundle install --binstubs
+```
+
+```
+cap install STAGES=homestead,test,prelive,live
+```
+
+Voeg toe aan Capfile
+
+```
+require 'capistrano/typo3'
+```
+
+
+
+### Stap 4
+
+in repo working copy
+
+```
+mkdir -p config/deploy/
+```
+
+vim config/deploy/prelive.rb
+
+pas aan met instellingen zoals: 
+
+```
+server 'xxxxx.xxxxxx.net', roles: %w{web}, port: 22
+
+set :user, 'userxxx'
+
+set :deploy_to, "/var/www/#{fetch(:user)}/point-prelive"
+set :tmp_dir, "/var/www/#{fetch(:user)}/tmp"
+set :ssh_options, { user: fetch(:user) }
+
+set :stage, :prelive
+set :http_protocol, 'http'
+set :branch, "master"
+set :t3_dont_upgrade_source, 1
+
+set :main_domain_name, 'xxxxx.net'
+
+set :dbname, 'dbxxx'
+set :dbuser, 'userxxx'
+set :dbpass, 'xxxxxx'
+set :dbhost, 'localhost'
+```
+
+and config/deploy.rb
+
+```
+set :application, 'point-env001-t3'
+
+set :repo_url, 'git@gitlab.lingewoud.net:HS-TYPO3/point-env001-t3.git'
+
+set :scm, :git
+set :log_level, :debug
+set :keep_releases, 5
+
+set :domain_org, 'point-prelive.dev2.lingewoud.net'
+
+set :t3_main_version, '7.6'
+```
+
+### Stap 5, download typo3
+
+```
+mkdir dummy
+cd dummy
+cd tar xzvf ~/Downloads/typo3_src-7.6.11.tar.gz
+ln -s typo3_src/index.php
+ln -s typo3_src/typo3
+cp typo3_src/_.htaccess .htaccess
+```
+
+commit and push
+
+
+### Stap 6, remote setup
+
+```
+typo3:helper:rm_deploy_to
+deploy
+typo3:helper:setup_shared_typo3_dirs
+typo3:helper:current_relative_symlink
+first_install
+```
+
+
+### Stap 7, maak in de browser de installatie van prelive af
+
+Haal daarna dummy/typo3conf/ naar local for import in git
+```
+rsync -av userdev@volkert.node.lingewoud.net:/var/customers/webs/userdev/point-prelive/current/dummy/typo3conf/ dummy/typo3conf/
+git add dummy
+git commit dummy
+git push
+```
+
+### Stap 8, maak test-env klaar
+
+
+maak configuratie van test in orde
+
+```
+
+```
+
+commit en push alles weg
+
+```
+git checkout -b developer
+git push --set-upstream origin developer
+```
+
+maak in deploy.rb de sync in orde
+
+```
+set :t3_live_sync, -> do
+  {
+    'filesync' => {
+      'fileadmin' => 'rsync -av xxxx@xxxx.net:/var/www/xxxx-prelive/shared/fileadmin/  shared/fileadmin/',
+      'uploads' => 'rsync -av xxxx@xxxx.net:/var/www/xxxx-prelive/shared/uploads/  shared/uploads/',
+    },
+    'dbsync' => {
+      'ssh_server' => 'xxxx.net',
+      'ssh_user' => 'userdev',
+      'dbname' => 'xxxx',
+      'dbuser' => 'xxxx',
+      'dbpass' => 'xxxx',
+      'dbhost' => 'xxxx',
+    },
+  }
+end
+
+set :t3_sql_updates, -> do
+  [
+#    "UPDATE sys_template SET constants = REPLACE(constants, 'http://www.#{fetch(:domain_org)}/','http://#{fetch(:main_domain_name)}/') where uid=1",
+#    "UPDATE sys_domain SET domainName = '#{fetch(:main_domain_name)}' WHERE uid = 1",
+#    "DELETE FROM sys_domain WHERE uid = 1",
+  ]
+end
+```
+
+
+### Stap 9 vagrant machine
+
+maak homestead conf.
+
+```
+server 'localhost', roles: %w{web allow_syncfiles allow_syncdatabase}, port: 2222
+set :user, 'vagrant'
+set :stage, :homestead
+set :deploy_to, '/var'
+set :ssh_options, { user: 'vagrant', port: 2222, keys: ['.vagrant/machines/default/virtualbox/private_key'] }
+set :tmp_dir, "/tmp"
+set :bundle_executable, "/usr/local/bin/bundle"
+set :restart_webserver, "sudo service nginx restart"
+
+set :branch, "developer"
+
+set :git_no_cache, 1
+
+set :t3_store_db_credentials_in_addionalconf, 1
+set :t3_add_unsafe_trusted_host_pattern, 1
+set :t3_dont_upgrade_source, 1
+
+set :hs_default_upstream_php_engine, 'php56'
+
+set :main_domain_name, 'local.typo3.org'
+set :dbname, 'captypo3homestead'
+set :dbuser, 'root'
+set :dbpass, 'supersecret'
+set :dbhost, 'localhost'
+
+sync_ignore_items = [
+#  '*.pdf'
+]
+sync_ignore = ''
+  sync_ignore_items.each do | ignore_item |
+  sync_ignore << "--exclude '#{ignore_item}' "
+end
+
+set :t3_rsync_ignore, sync_ignore
+set :t3_protocol, "http"
+```
+
+
+### Stap 10 Setup machine
+
+
+installeer de juiste vagrant.yml en Vagrantfile
+
+
+```
+./bin/cap homestead  typo3:vagrant:setup_machine
+```
+
+
+### Stap 20 Setup gitlab-ci.yml
+
+set key in variablen van gitlab
+
+keynaam: SSH_PRIVATE_KEY
+kay waarde: een key die met test en prelive ssh mag connecten
+
+### Stap xxx Maak backend test gebruiker met nieuwe ww:
+
+automated_test web->page
+
+### voeg minitest en watir toe