�ݺ�ߣ

DDEV
Jigal van Hemert
jigal.van.hemert@typo3.org
@jigalvh
Docker made easy

D-WHAT??
23-06-2018 ddev: docker made easy 2

CONTAINERS - DOCKER
? Lightweight virtual machine
? Linux based, compressed
? Supported by major virtualization players
? Supported in deployment solutions

DDEV - DOCKER
? DDEV:
? pre-built containers
? configuration for WordPress, Drupal,
Backdrop, TYPO3
? Contains: db, nginx, solr, PHP 5.6-7.2, xdebug
? Your own additional services

WORKSHOP

AGENDA
23-06-2018 6ddev: docker made easy
1. Requirements
2. Installation
3. Project configuration
4. Daily use
5. Extending the configuration

REQUIREMENTS
What do I need to run ddev?

REQUIREMENTS
? Docker version 17.05 or higher
? Docker compose 1.10.0 or higher
? macOS Sierra and higher
? Windows 10 Pro (Home recently supported)
? Linux (Ubuntu 14.04+, Debian Jessie+, Fedora 25+, ...)

INSTALLATION
Get things running...

INSTALLATION
Homebrew �C macOS
brew tap drud/ddev && brew install ddev

INSTALLATION
Linux and macOS �C install script
curl https://raw.githubusercontent.com/?
drud/ddev/master/install_ddev.sh | bash

INSTALLATION
Windows 10
ddev_windows_installer.<version>.exe

PROJECT
CONFIGURATION
Set up a project

CONFIGURATION
ddev config

CONFIGURATION
? Name
? Docroot
? Type of project

DAILY USE
Get productive

CONFIGURATION
ddev start

CONFIGURATION
? Starts environment
? Checks/creates containers
? Creates/starts router

CONFIGURATION
ddev stop

CONFIGURATION
? Stops router
? Shuts down containers
? Stops environment

LET��S
START A
PROJECT

DEMO PROJECT
mkdir ddevproject
cd ddevproject

DEMO PROJECT
ddev config

DEMO PROJECT
Creating a new ddev project config in the current directory (D:t3dd18ddevproject)
Once completed, your configuration will be written to D:t3dd18ddevproject.ddev
config.yaml
Project name (ddevproject):
The docroot is the directory from which your site is served. This is a relative path
from your project root (D:t3dd18ddevproject)
You may leave this value blank if your site files are in the project root
Docroot Location (current directory):
Found a php codebase at D:t3dd18ddevproject.
Project Type [php, drupal6, drupal7, drupal8, wordpress, typo3, backdrop] (php):
typo3
TYPO3 does not seem to have been set up yet, missing LocalConfiguration.php (D:
t3dd18ddevprojecttypo3confAdditionalConfiguration.php)
Generating LocalConfiguration.php file for database connection.
Unable to create settings file: Failed to write TYPO3 AdditionalConfiguration.php
file: chmod D:t3dd18ddevprojecttypo3conf: The system cannot find the file
specified.
Configuration complete. You may now run 'ddev start'.

DEMO PROJECT
ddev start

DEMO PROJECT
Starting environment for ddevproject...
Warning: containers will run as root. This is fine on Docker
for Windows or Docker for Mac, but could be a security risk on
Linux.
Starting ddev-ddevproject-db ... done
Starting ddev-ddevproject-dba ... done
Starting ddev-ddevproject-web ... done
Network ddev_default is external, skipping
Creating ddev-router ... done
Successfully started ddevproject
Your project can be reached at http://ddevproject.ddev.local,
https://ddevproject.ddev.local

DEMO PROJECT
ddev hostname ddevproject.ddev.local
127.0.0.1
ddev hostname ddevproject.ddev.local ::1

DEMO PROJECT
ddev ssh
winpty ddev ssh
Windows:

DEMO PROJECT
Warning: containers will run as root. This
is fine on Docker for Windows or
Docker for Mac, but could be a security
risk on Linux.
Warning: containers will run as root. This
is fine on Docker for Windows or
Docker for Mac, but could be a security
risk on Linux.

DEMO PROJECT
composer create-project
jigal/ddevt3dd18 ./temptarget

DEMO PROJECT
Installing jigal/ddevt3dd18 (dev-master 448831c4595bf10bc213d182cc7be47d2dfc834c)
- Installing jigal/ddevt3dd18 (dev-master master): Cloning master
Created project in ./temptarget
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 48 installs, 0 updates, 0 removals
- Installing typo3/class-alias-loader (1.0.0): Downloading (100%)
- Installing typo3/cms-composer-installers (v1.5.2): Downloading (100%)
- Installing helhum/typo3-console-plugin (2.0.4): Downloading (100%)
- Installing symfony/dotenv (v4.1.0): Downloading (100%)
- Installing helhum/dotenv-connector (v2.1.0): Downloading (100%)
- Installing mso/idna-convert (v1.1.0): Downloading (100%)
- Installing cogpowered/finediff (0.3.1): Downloading (100%)
- Installing helhum/config-loader (v0.9.0): Downloading (100%)
- Installing symfony/process (v4.1.0): Downloading (100%)
- Installing symfony/polyfill-mbstring (v1.8.0): Downloading (100%)
- Installing symfony/console (v4.1.0): Downloading (100%)
- Installing psr/log (1.0.2): Loading from cache
- Installing doctrine/lexer (v1.0.1): Downloading (100%)
- Installing doctrine/annotations (v1.6.0): Downloading (100%)
- Installing typo3/cms-core (v8.7.16): Downloading (100%)
- Installing typo3/cms-scheduler (v8.7.16): Downloading (100%)
- Installing helhum/typo3-console (5.4.0): Downloading (100%)
- Installing typo3fluid/fluid (2.5.3): Downloading (100%)
- Installing symfony/finder (v4.1.0): Downloading (100%)
- Installing doctrine/inflector (v1.3.0): Downloading (100%)
- Installing doctrine/collections (v1.5.0): Downloading (100%)
- Installing doctrine/cache (v1.7.1): Downloading (100%)
- Installing doctrine/common (v2.7.3): Downloading (100%)
- Installing doctrine/dbal (v2.5.13): Downloading (100%)
- Installing guzzlehttp/promises (v1.3.1): Downloading (100%)
- Installing psr/http-message (1.0.1): Downloading (100%)
- Installing guzzlehttp/psr7 (1.4.2): Downloading (100%)
- Installing guzzlehttp/guzzle (6.3.3): Downloading (100%)

DEMO PROJECT
- Installing doctrine/instantiator (1.0.5): Downloading (100%)
- Installing symfony/polyfill-ctype (v1.8.0): Downloading (100%)
- Installing swiftmailer/swiftmailer (v5.4.9): Downloading (100%)
- Installing helhum/typo3-composer-setup (v0.5.2): Downloading (100%)
- Installing typo3/cms-sv (v8.7.16): Downloading (100%)
- Installing symfony/yaml (v4.1.0): Downloading (100%)
- Installing typo3/cms-saltedpasswords (v8.7.16): Downloading (100%)
- Installing typo3/cms-recordlist (v8.7.16): Downloading (100%)
- Installing typo3/cms-extensionmanager (v8.7.16): Downloading (100%)
- Installing typo3/cms-lang (v8.7.16): Downloading (100%)
- Installing typo3/cms-extbase (v8.7.16): Downloading (100%)
- Installing typo3/cms-fluid (v8.7.16): Downloading (100%)
- Installing typo3/cms-install (v8.7.16): Downloading (100%)
- Installing typo3/cms-frontend (v8.7.16): Downloading (100%)
- Installing typo3/cms-filelist (v8.7.16): Downloading (100%)
- Installing typo3/cms-cshmanual (v8.7.16): Downloading (100%)
- Installing typo3/cms-backend (v8.7.16): Downloading (100%)
- Installing typo3/cms-fluid-styled-content (v8.7.16): Downloading (100%)
- Installing typo3/cms-rte-ckeditor (v8.7.16): Downloading (100%)
helhum/config-loader suggests installing ext-yaml (For improved performance when parsing yaml files you should use the PECL YAML Parser php extension)
symfony/console suggests installing symfony/event-dispatcher ()
symfony/console suggests installing symfony/lock ()
symfony/console suggests installing psr/log-implementation (For using the console logger)
doctrine/cache suggests installing alcaeus/mongo-php-adapter (Required to use legacy MongoDB driver)
helhum/typo3-composer-setup suggests installing pagemachine/typo3-composer-legacy-cli (Provides the legacy cli_dispatch.phpsh entry point for TYPO3.)
typo3/cms-saltedpasswords suggests installing typo3/cms-rsaauth (*)
typo3/cms-rte-ckeditor suggests installing typo3/cms-setup (*)
Writing lock file
Generating autoload files
Registered helhum/dotenv-connector
Generating class alias map file
Inserting class alias loader into main autoload.php file
Do you want to remove the existing VCS (.git, .svn..) history? [Y,n]?Y

DEMO PROJECT
mv temptarget/* .
mv temptarget/.gitignore .
rmdir temptarget

DEMO PROJECT
composer dumpautoload
exit
ddev config

DEMO PROJECT
You are reconfiguring the project at D:t3dd18ddevproject.
The existing configuration will be updated and replaced.
Project name (ddevproject):
The docroot is the directory from which your site is served. This is a
relative path from your project root (D:t3dd18ddevproject)
You may leave this value blank if your site files are in the project root
Docroot Location (web):
Found a typo3 codebase at D:t3dd18ddevprojectweb.
Project Type [wordpress, typo3, backdrop, php, drupal6, drupal7, drupal8]
(typo3):
TYPO3 does not seem to have been set up yet, missing
LocalConfiguration.php (D:t3dd18ddevprojectwebtypo3conf
AdditionalConfiguration.php)
Generating LocalConfiguration.php file for database connection.
Configuration complete. You may now run 'ddev start'.

DEMO PROJECT
ddev start
winpty ddev ssh

DEMO PROJECT
../vendor/bin/typo3cms install:setup

DEMO PROJECT
Welcome to the TYPO3 Console installer!
? Prepare installation
? Check environment and create folders
? Skipped Set up database connection
? Skipped Select database
? Set up database
Username of to be created administrative user account (required): jigal
Password of to be created administrative user account (required):
Name of the TYPO3 site (default: "New TYPO3 Console site"): ddevt3dd18
? Ok
? Set up configuration
Specify the site setup type (default: "no"):
[no ] Do nothing
[site] Create root page
> site
? Ok
? Set up extensions
Successfully installed TYPO3 CMS!

DEMO PROJECT BACKEND

DEMO PROJECT FRONTEND

WHAT ELSE IS
THERE?

PHP VERSION
ddev describe

PHP VERSION
NAME TYPE LOCATION URL(s) STATUS
ddevproject typo3 D:/t3dd18/ddevproject http://ddevproject.ddev.local running
https://ddevproject.ddev.local
Project Information
-----------------
PHP version: 7.1
URLs: http://ddevproject.ddev.local, https://ddevproject.ddev.local
MySQL Credentials
-----------------
Username: db
Password: db
Database name: db
Host: db
Port: 3306
To connect to mysql from your host machine, use port 32768 on 127.0.0.1.
For example: mysql --host=127.0.0.1 --port=32768 --user=db --password=db --database=db
Other Services
--------------
MailHog: http://ddevproject.ddev.local:8025
phpMyAdmin: http://ddevproject.ddev.local:8036
DDEV ROUTER STATUS: healthy

PHP VERSION
less .ddev/config.yaml

PHP VERSION
APIVersion: "1"
name: ddevproject
type: typo3
docroot: web
php_version: "7.1"
webimage: drud/nginx-php-fpm-local:v1.2.2
dbimage: drud/mariadb-local:v0.9.0
dbaimage: drud/phpmyadmin:v0.2.0
router_http_port: "80"
router_https_port: "443"
additional_hostnames: []
provider: default
# Key features of ddev's config.yaml:
# name: <projectname> # Name of the project, automatically provides
# http://projectname.ddev.local and https://projectname.ddev.local
# type: <projecttype> # drupal6/7/8, backdrop, typo3, wordpress, php
# docroot: <relative_path> # Relative path to the directory containing index.php.
# php_version: "7.1" # PHP version to use, "5.6", "7.0", "7.1", "7.2"

ENVIRONMENT VARIABLES
? .ddev/docker-compose.<something>.yaml

ENVIRONMENT VARIABLES
version: '3'
services:
web:
environment:
- TYPO3_CONTEXT=Development

�� AND MORE
? MailHog
? PhpMyAdmin
? Xdebug
? Apache Solr container

EXTENDING DDEV
I want more and I want it now!

EXTENDING DDEV
https://ddev.readthedocs.io/en/latest/
users/extending-commands/

EXTENDING DDEV
? Hooks to run:
- pre/post
- start / import-db / import-files
? In .ddev/config.yaml file

EXTENDING DDEV
? Additional hostnames
? Custom configuration for nginx, PHP,
MariaDB
? Custom services in containers

THANK YOU!

�ݺ�ߣ

Ddev workshop t3dd18

Recommended

More Related Content

Similar to Ddev workshop t3dd18 (20)

More from Jigal van Hemert (8)

Recently uploaded (20)

Ddev workshop t3dd18