DDEV - Extended

Christian Münch / @cmuench / muench.devChristian Münch / @cmuench / muench.dev 11

Beispiel Projekt
Ziel: PHP Anwendung mit Zugriff auf
ElasticSearch
22Christian Münch / @cmuench / muench.devChristian Münch / @cmuench / muench.dev

Verzeichnis
.
├── composer.json
└── index.php

Minimale
composer.json
{
"name": "muench-dev/example-project",
"description": "ddev Example Project",
"type": "project",
"license": "MIT",
"authors": [
{
"name": "Christian Münch",
"email": "christian@muench-worms.de"
}
],
"require": {
"elasticsearch/elasticsearch": "^7.9"
}
44

index.php
<?php
require_once 'vendor/autoload.php';
phpinfo();

Let's go!
ddev config --project-name=example-project --php-version=7.4 --project
ddev start

❯ ddev start
Starting example-project...
Pushed mkcert rootca certs to ddev-global-cache/mkcert
Running Command=ip address show dev docker0
Building db
Building web
Creating ddev-example-project-db ... done
Creating ddev-example-project-web ... done
Creating ddev-example-project-dba ... done
Creating ddev-router ... done
Successfully started example-project
Project can be reached at https://example-project.ddev.site https://127.0.0.1:32786

PHP Projekt
ddev composer install

❯ ddev composer install
No lock file found. Updating dependencies instead of installing from lo
Loading composer repositories with package information
Updating dependencies
Lock file operations: 5 installs, 0 updates, 0 removals
- Locking elasticsearch/elasticsearch (v7.9.1)
- Locking ezimuel/guzzlestreams (3.0.1)
- Locking ezimuel/ringphp (1.1.2)
- Locking psr/log (1.1.3)
- Locking react/promise (v2.8.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 5 installs, 0 updates, 0 removals
- Installing psr/log (1.1.3): Extracting archive
- Installing react/promise (v2.8.0): Extracting archive
- Installing ezimuel/guzzlestreams (3.0.1): Extracting archive
- Installing ezimuel/ringphp (1.1.2): Extracting archive
- Installing elasticsearch/elasticsearch (v7.9.1): Extracting archive
1 package suggestions were added by new dependencies, use `composer sug
Generating autoload files 99

Mac Performance
ddev config --nfs-mount-enabled=true

NFS ist für jeden
angeschaltet!

Lösung
anlegen einer lokalen Config
Dateien /config.*.y*ml sind per .gitignore
ausgeschlossen.

Beispiel
config.local.yaml
nfs_mount_enabled: false

Tipp: Bash Alias
ddev-disable-nfs-mount-locally='echo "nfs_mount_enabled: false" >> .ddev/config.local.yaml'

NFS Problematiken
NFS muss installiert sein -> Sonst kommen komische
Fehlermeldungen
NFS Installation je Betriebssystem unter schiedlich
Unterschiedliche Partitionierung
Unterschiedliche Benutzer-IDs
Keine Inotify Events (Watch-Tasks z.B. grunt, webpack,
Magento Cache Clean)

Inotify Proxy
Diverse Lösungen erhältlich
Bekanntes NPM Paket ist nur ein Wrapper für eine C-Lib
und benötigt installierte Build-Tools.
Kleiner, schneller, golang
https://github.com/cmuench/inotify-proxy
ddev Command:
https://github.com/cmuench/inotify-proxy/wiki/ddev-
inotify-Command

Homeadditions
.ddev/homeadditions
~/.ddev/homeadditions
.
└── homeadditions
├── bash_aliases.example
└── .bashrc

Beispiel .bashrc
export PS1="[e[32m][[e[m][e[36m][e[m][e[32m]h[e[m]:
alias ls='ls --color=auto'
alias ll='ls -la'
alias cd-root="cd /var/www/html"

Verzeichnisse
.
├── commands
│   ├── db
│   ├── host
│   ├── solr
│   └── web

Host Commands
Beispiel: ~/.ddev/commands/host/ide

!/bin/bash
#ddev-generated
## Description: Open project in IDE
## Usage: ide
## Example: "ddev ide"
/opt/intellij-idea-ultimate-edition/bin/idea.sh ${DDEV_APPROOT}
> /dev/null 2>&1 &

Container Commands

Magento Kommando
#!/bin/bash
#ddev-generated
## Description: Run magento CLI inside the web container
## Usage: magento [flags] [args]
## Example: "ddev magento list" or "ddev magento maintenance:enable"
## ProjectTypes: magento2
bin/magento "$@"

docker-compose
Konfiguration
docker-compose up -d
docker-compose -f docker-compose.yaml up -d
docker-compose -f foo.yaml -f bar.yaml -f zoz.yaml up -d

Verzeichnisstruktur
.ddev
├── .ddev-docker-compose-base.yaml
├── .ddev-docker-compose-full.yaml
├── config.yaml
├── db-build
│ └── Dockerfile.example
└── web-build
└── Dockerfile.example

Beispiel ElasticSearch
...

version: '3.6'
services:
elasticsearch:
container_name: 'ddev-${DDEV_SITENAME}-elasticsearch'
hostname: '${DDEV_SITENAME}-elasticsearch'
image: elasticsearch:7.6.2
ports:
- '9200'
- '9300'
environment:
- VIRTUAL_HOST=elasticsearch-$DDEV_HOSTNAME
- HTTP_EXPOSE=9200
- discovery.type=single-node
labels:
com.ddev.site-name: '${DDEV_SITENAME}'
com.ddev.approot: $DDEV_APPROOT
volumes:
- 'elasticsearch:/usr/share/elasticsearch/data'
3131

version: '3.6'
services:
elasticsearch:
...
web:
depends_on:
- elasticsearch
links:
- 'elasticsearch:elasticsearch'
volumes:
elasticsearch:
name: '${DDEV_SITENAME}-elasticsearch'

❯ ddev start
Running Command=ip address show dev docker0
Creating volume "example-project-elasticsearch" with default driver
Building db
Building web
Creating ddev-example-project-elasticsearch ... done
Recreating ddev-example-project-db ... done
Recreating ddev-example-project-dba ... done
Recreating ddev-example-project-web ... done

ddev describe
$> ddev describe
...
Other Services
--------------
MailHog (https): https://example-project.ddev.site:8026
MailHog: http://example-project.ddev.site:8025
phpMyAdmin (https): https://example-project.ddev.site:8037
phpMyAdmin: http://example-project.ddev.site:8036
elasticsearch: http://example-project.ddev.site:9200
...

❯ ddev exec "curl http://elasticsearch:9200"
{
"name" : "example-project-elasticsearch",
"cluster_name" : "docker-cluster",
"cluster_uuid" : "fX7_HMTxRiC_1KL4nbTqAg",
"version" : {
"number" : "7.6.2",
"build_flavor" : "default",
"build_type" : "docker",
"build_hash" : "ef48eb35cf30adf4db14086e8aabd07ef6fb113f",
"build_date" : "2020-03-26T06:34:37.794943Z",
"build_snapshot" : false,
"lucene_version" : "8.4.0",
"minimum_wire_compatibility_version" : "6.8.0",
"minimum_index_compatibility_version" : "6.0.0-beta1"
},
"tagline" : "You Know, for Search"
}

<?php
require_once 'vendor/autoload.php';
use ElasticsearchClientBuilder;
$params = [
'hosts' => [
'elasticsearch:9200'
]
];
try {
$client = ClientBuilder::fromConfig($params);
$client->ping();
echo "ElasticSearch connection established";
} catch (Exception $exception) {
echo $exception->getMessage();
exit(1);
} 3636Christian Münch / @cmuench / muench.devChristian Münch / @cmuench / muench.dev

Christian Münch / @cmuench / muench.devChristian Münch / @cmuench / muench.dev 3737

Command Hooks
pre-<command>
post-<command>
Beispiel:
pre-start
post-import-db
post-composer

Tasks
exec -> Im Container (genormte Umgebung)
exec_host -> Auf dem Host (Achtung!)
composer -> Führt ein Composer Kommando aus

config.yaml Anpassung
hooks:
post-start:
- composer: install

❯ ddev start
...
Executing post-start hook...
=== Running task: Composer command 'install' in web container, output below
Installing dependencies from lock file (including require-dev)
Verifying lock file contents can be installed on current platform.
Nothing to install, update or remove
Generating autoload files
...
4242

Shell Scripte
hooks:
post-start:
- exec: bash .ddev/step1_install_special_tools.sh
- exec: bash .ddev/step2_setup_myapplication.sh
# other container
- exec: bash .ddev/do_some_db_stuff.sh
service: db
- exec: bin/elasticsearch-plugin install analysis-icu
service: elasticsearch

=== Running task: Exec command 'bin/elasticsearch-plugin
install analysis-icu' in container/service 'elasticsearch', output below
-> Installing analysis-icu
-> Downloading analysis-icu from elastic
[=================================================] 100%??
-> Installed analysis-icu

Vielen Dank!
Fragen oder Livedemo?

DDEV - Extended

More Related Content

What's hot

Similar to DDEV - Extended

More from Christian Münch

Recently uploaded

DDEV - Extended