Any developer who has worked in team will have to face the activity of setting up their local work environment to start contributing to the project. Whether you are working remotely or onsite, this kind of activity is often time consuming due to the personal configurations of your workstation. This "time wasting" is not predictable and even justifiable to the customer, that is the issue. I think the only way to fix that it's to find a reproducible process which takes the same time to be completed, indipendently by the operating system and configurations. This is why, starting from the last project I've been involved in, I started to lay the groundwork to build it using Docker, Config Split, Drupal Console and Drush. My session is aimed at programmers and project managers looking for a way to bring new developers on board and make them operational in a given time. It will be a good starting point to discuss about that.

1. LISBON 2018
DRUPAL DEVELOPER DAYS
Welcome aboard the team
Roberto Peruzzo

2. Agenda
• Why on-boarding is expensive
• Ingredients to make easy on-boarding
• My recipe

3. Diamond Sponsor

4. Platinum Sponsors

5. Gold Sponsors

6. Roberto Peruzzo
@robertoperuzzo
www.studioaqua.it
it.linkedin.com/in/robertoperuzzo
www.robertoperuzzo.it
Freelance Web Developer

7. Where I live

8. Bassano del Grappa

9. Grappa Nardini

10. http://www.thanksskateboardingmag.com

11. https://www.studioaqua.it

12. What we do?
• Develop new features
• Manage security updates
• Design Drupal projects from scratch

13. https://www.drupal.org/project/iubenda_integration

14. W H Y I S A N E W M E M B E R
E X P E N S I V E ?

15. The working team is like a family

16. New member can…
• help to reach your goals
• show you something in a different point of view
• improve the quality of what you are doing
• teach you something new

17. I've learned…

18. Breakdown of plans

19. Because you probably don’t know what he/she needs.
Why?

20. Everyone uses their own tools

21. The best path to follow
• OS independent
• Less tools installed
• Automate as much as you can
• Local and Live environments have the same settings

22. M Y R E C I P E

23. My Recipe
• 1 Git project repo
• 1 Docker application
• 1 docker-compose.yml by Wodby
• 1 RoboFile.php

24. Git is a free and open source distributed version control
system designed to handle everything from small to very
large projects with speed and efficiency.
Git
https://github.com/robertoperuzzo/ddd-lisbon2018

25. https://nvie.com/posts/a-successful-git-
branching-model/
A successful Git
branching model
(Vincent Driessen)

26. It is a container platform provider that enables true
independence between applications and infrastructure
and developers and IT ops to unlock their potential and
creates a model for better collaboration and innovation.
Docker
https://www.docker.com/what-docker

27. A container image is a
lightweight, stand-alone,
executable package of a
piece of software that includes
everything needed to run it:
code, runtime, system tools,
system libraries, settings.
Docker container
https://www.docker.com/what-container

28. Containers are more portable and efficient
Containers Virtual Machines

29. With Docker you can create containers holding project specific
data while they depend on common images. You can even copy
whole development environments from one machine to another or
only share the settings of a development environment with others.
Why use Docker?
https://www.drupal.org/node/2736447

30. Docker4Drupal is a set of docker images optimized for
Drupal. Use docker-compose.yml file from the latest stable
release to spin up local environment on Linux, Mac OS X
and Windows.
Docker4drupal
https://github.com/wodby/docker4drupal

31. Robo is a task runner you always have been looking for. It
allows you to write fully customizable tasks in common OOP
PHP style.
Robo.li
https://robo.li

32. P R E PA R I N G Y O U R P R O J E C T
L O C A L D E V S E T T I N G S

33. docker-compose.yml - mariadb
mariadb:
image: wodby/mariadb:$MARIADB_TAG
container_name: "${PROJECT_NAME}_mariadb"
stop_grace_period: 30s
environment:
MYSQL_ROOT_PASSWORD: $DB_ROOT_PASSWORD
MYSQL_DATABASE: $DB_NAME
MYSQL_USER: $DB_USER
MYSQL_PASSWORD: $DB_PASSWORD
# volumes:
# - ./mariadb-init:/docker-entrypoint-initdb.d # Place init .sql file(s) here.
# - /path/to/mariadb/data/on/host:/var/lib/mysql # I want to manage volumes
manually.

34. docker-compose.yml - php
php:
image: wodby/drupal-php:$PHP_TAG
container_name: "${PROJECT_NAME}_php"
environment:
PHP_SENDMAIL_PATH: /usr/sbin/sendmail -t -i -S mailhog:1025
DB_HOST: $DB_HOST
DB_USER: $DB_USER
DB_PASSWORD: $DB_PASSWORD
DB_NAME: $DB_NAME
DB_DRIVER: $DB_DRIVER
volumes:
## For macOS users (https://docs.docker.com/docker-for-mac/osxfs-caching/)
- ./:/var/www/html:delegated

35. docker-compose.yml - ngnix
nginx:
image: wodby/drupal-nginx:$NGINX_TAG
container_name: "${PROJECT_NAME}_nginx"
depends_on:
- php
environment:
NGINX_STATIC_CONTENT_OPEN_FILE_CACHE: "off"
NGINX_ERROR_LOG_LEVEL: debug
NGINX_BACKEND_HOST: php
NGINX_SERVER_ROOT: /var/www/html/web
volumes:
- ./:/var/www/html:delegated
labels:
- 'traefik.backend=nginx'
- 'traefik.port=80'
- 'traefik.frontend.rule=Host:${PROJECT_BASE_URL}'
https://docs.docker.com/docker-for-mac/osxfs-caching/#delegated

36. https://store.docker.com/editions/community/docker-ce-desktop-mac
Delegated flag needs Docker CE edge channel.

37. settings.php
// Set up a config sync directory.
// This is defined inside the read-only "config" directory, deployed via
Git.
$config_directories[CONFIG_SYNC_DIRECTORY] = $app_root . '/../config/
sync';
// Local settings. These come last so that they can override anything.
if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
include $app_root . '/' . $site_path . '/settings.local.php';
}

38. settings.local.php - database
// Docker database container setting.
$databases['default']['default'] = [
'database' => 'drupal',
'username' => 'drupal',
'password' => 'drupal',
'prefix' => '',
'host' => 'mariadb',
'port' => '3306',
'namespace' => 'DrupalCoreDatabaseDrivermysql',
'driver' => 'mysql',
];

39. settings.local.php - trusted host
// Trusted hosts.
$settings['trusted_host_patterns'] = [
'^ddd18.docker.localhost$',
];

40. Setup Robo
> cd myproject
> composer require consolidation/robo
> ./vendor/bin/robo init

41. RoboFile.php
<?php
class RoboFile extends RoboTasks {
/**
* Set up the local dev environment ready to start working
on.
*/
public function build() {
// Put here your tasks.
}
}

42. RoboFile.php - drupal init
// Drupal init.
$this->taskExecStack()
->stopOnFail()
->exec('make up')
->exec('docker-compose exec --user 82 php drupal init --
destination=/var/www/html/console/ --no-interaction')
->run();

43. RoboFile.php - local settings
// Local settings.
$this->taskFilesystemStack()
->stopOnFail()
->chmod('web/sites/default', 0755)
->symlink('../../../settings.local.php', 'web/sites/
default/settings.local.php')
->chmod('web/sites/default', 0555)
->run();

44. RoboFile.php - drupal install
// Drupal install.
$this->taskExecStack()
->exec('docker-compose exec --user 82 php drupal
site:install --force --no-interaction')
->run();

45. RoboFile.php - db settings
// Remove database settings from settings.php.
$this->taskFilesystemStack()
->chmod('web/sites/default/settings.php', 0644)
->run();
$this->taskReplaceInFile('web/sites/default/settings.php')
->regex('/$databases[([.Ss]*));/i')
->to('')
->run();
$this->taskFilesystemStack()
->chmod('web/sites/default/settings.php', 0444)
->run();

46. W H AT T H E N E W M E M B E R H A S
T O D O

47. Clone the project
> git clone <git-repo> <project-name>

49. Build the project
> cd <project-name>
> composer install

51. Run Docker

52. Build the local environment
> ./vendor/bin/robo build

55. D E M O T I M E

56. A N Y Q U E S T I O N S ?
@robertoperuzzo
roberto.peruzzo@studioqua.it

57. @robertoperuzzo
T H A N K S F O R Y O U R T I M E !