dreadlabs/vantomas

A TYPO3.CMS project encapsulating the website www.van-tomas.

Saturday, April 29, 2017
by dreadwarrior
Repository
3 Watchers
5 Stars
17 Installations

PHP
0 Dependents
0 Suggesters
2 Forks
3 Open issues
46 Versions
0 % Grown

The README.md

vantomas

A TYPO3.CMS project encapsulating the website www.van-tomas.de, _(*1)

Build status

, _(*2)

, _(*3)

Prerequisites
- .env file
Installation
Build
Release
Syncing
Running phinx migration from cli
Todo
How to...
License

Prerequisites

To run the project locally, make sure you have installed VirtualBox and vagrant., _(*4)

Please activate ssh agent forwarding and SSH key authentification on the remote server if you want to make use of database/file syncing or rsync deployment., _(*5)

The provision, build, downsync and deploy processes uses ansible. Please ensure it's installed on your host machine., _(*6)

TL;DR, _(*7)

VirtualBox ~5.0.10
vagrant ~1.7.4
ansible ~1.9.4

.env file

The project is operating with environment files in order to separate code from configuration. See the file .env.dist shipped with this project, adjust to your needs and ensure it will be available from the project root directory., _(*8)

For more information, read the Config section of the "The Twelve Factor App" manifest. For a controversial consideration, please read Environment Variables Considered Harmful for Your Secrets., _(*9)

Installation

~ $ php composer.phar create-project -s dev dreadlabs/vantomas
~ $ cd vantomas
~ $ vagrant up

Hint: to re-run provision, you can do so by executing one of the following commands:, _(*10)

~ $ vagrant provision

or, _(*11)

~ $ ansible-playbook ./.ansible/playbooks/provision.yml

Build

~ $ ansible-playbook .ansible/playbooks/build.yml

Release

The release defaults to Pull releases with Travis., _(*12)

You can Push release if you're not using a Continuous Integration system., _(*13)

Syncing

Please read the Release Inventory chapter and make sure you created proper inventory groups as they are important also for downsyncing data from remotes., _(*14)

After that you're able to downsync database and files with the following command:, _(*15)

~$ ansible-playbook .ansible/playbooks/downsync-data.yml -i .ansible/inventories/nicknack_<testing|production>

You can split the process further down with using tags targeting a specific part of the downsync:, _(*16)

~$ ansible-playbook .ansible/playbooks/downsync-data.yml -i .ansible/inventories/nicknack --limit <production|testing> [-t <database|files>]

Import via:, _(*17)

~$ .script/console db -h db <Database name> -e "SET names 'utf8'; SOURCE /app/data/db/<dump name>.sql;"

Running phinx migration from cli

The phinx.yml makes usage of the environment variables described in the .env file section. To source the variables and execute phinx you can issue one of the following commands:, _(*18)

# posix shell
#
# The -a switch exports all variables, so that they are available to the program.
#
# @source: http://serverfault.com/a/540484
#
~ $ sh -ac '. ./.env; vendor/bin/phinx command [options] [arguments]'

# bash
#
# @source: http://stackoverflow.com/a/30969768
#
~ $ bash -c 'set -o allexport; source .env; vendor/bin/phinx command [options] [arguments]'

Todo

Evaluate integration of http://serverfault.com/a/316100 (ssh-keygen / ssh-keyscan for ~/.ssh/known_hosts), _(*19)

How to...

...see what hosts would be affected by a playbook before I run it?, _(*20)
```
ansible-playbook playbook.yml --list-hosts
```

...compare remote and local directory to check rsync deployment, _(*21)

diff <(ssh user@host ls -R /path/to/remote/folder/) <(ls -R /path/of/local/folder/) > diff.log

...get the latest annotated tag which targets only the current commit in the current branch?, _(*22)
```
git describe --exact-match --abbrev=0
```

License

The following directories and their contents are Copyright Thomas Juhnke. You may not reuse anything therein without my permission:, _(*23)

src/vantomas/Resources/Public/Images/ (except child folders)

Photo credit src/vantomas/Resources/Public/Images/sleeping-kittens.jpg:, _(*24)

sleeping kittens by Jimmy B, CC licensed, _(*25)

All other directories and files are GPL v2 Licensed. Feel free to use the HTML and CSS as you please. If you do use them, a link back to http://github.com/dreadwarrior/vantomas would be appreciated, but is not required., _(*26)

The Versions

29/04 2017

3.6.x-dev

3.6.9999999.9999999-dev http://www.van-tomas.de/

A TYPO3.CMS project encapsulating the website www.van-tomas.

project vantomas

A TYPO3.CMS project encapsulating the website www.van-tomas.

dreadlabs/vantomas

The README.md

vantomas

Build status

Table of contents

Prerequisites

.env file

Installation

Build

Release

Syncing

Running phinx migration from cli

Todo

How to...

License

The Versions

3.6.x-dev

The Requires

The Development Requires

by Thomas Juhnke

3.6.14

The Requires

The Development Requires

by Thomas Juhnke

dev-master

The Requires

The Development Requires

by Thomas Juhnke

3.6.13

The Requires

The Development Requires

by Thomas Juhnke

3.6.12

The Requires

The Development Requires

by Thomas Juhnke

3.6.11

The Requires

The Development Requires

by Thomas Juhnke

3.6.10

The Requires

The Development Requires

by Thomas Juhnke

3.6.9

The Requires

The Development Requires

by Thomas Juhnke

3.6.8

The Requires

The Development Requires

by Thomas Juhnke

3.6.7

The Requires

The Development Requires

by Thomas Juhnke

3.6.6

The Requires

The Development Requires

by Thomas Juhnke

3.6.5

The Requires

The Development Requires

by Thomas Juhnke

3.6.4

The Requires

The Development Requires

by Thomas Juhnke

3.6.3

The Requires

The Development Requires

by Thomas Juhnke

3.6.2

The Requires

The Development Requires

by Thomas Juhnke

3.6.1

The Requires