Skip to content
Snippets Groups Projects
README.md 2 KiB
Newer Older
  • Learn to ignore specific revisions
  • jurgenhaas's avatar
    jurgenhaas committed
    # LakeDropsDrupalDev - L3D
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    Provides fully configured Docker images for local Drupal development where your local host requires nothing else than Docker being installed but no PHP, Composer or any other tool on this planet. It simply works.
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    ## Prerequisites
    
    Nothing else than docker and this [script](https://gitlab.lakedrops.com/docker/l3d/raw/master/l3d) being installed on your host. You don't need any other tool - none!
    
    Ideally you download that script and copy that to a directory in your search path (e.g. `/usr/local/bin`), then it will be available for all your Drupal projects.
    
    ## Quick start
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    Go to the project root for which you want to use **L3D** and execute the downloaded script (simply type `l3d` at the command prompt). It will ask you for the PHP version to be used (input `7.0`, `7.1` or `7.2`) and it will download the matching L3D image and start a container for you.
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    Inside the container you'll find the directory `/drupal` which contains everything from your project's root. You can work from there by using these available tools:
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    | Tool | Command | Shortcut |
    | --- | --- | --- |
    | Ahoy | `ahoy` | `a` |
    | Composer | `composer` | `c` |
    | Docker | `docker` | |
    | Docker Composer | `docker-compose` | `d-c` |
    | DorgFlow | `dorgflow` | |
    | Drush | `drush` | `d` |
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    ## Update the image
    
    jurgenhaas's avatar
    jurgenhaas committed
    
    
    When starting **L3D** with the script this will simply re-use the latest available image in your local docker environment. To force your docker to download the latest version of an image you can use `l3d -u` which will also start the working container for you but check for an updated version of the image first.
    
    ## Examples
    
    ### Start a new project
    
    ```bash
    cd /var/www
    mkdir testproject1
    cd testproject1
    l3d
    wget https://gitlab.lakedrops.com/composer/project/drupal-8/raw/master/.gitignore
    wget https://gitlab.lakedrops.com/composer/project/drupal-8/raw/master/composer.json
    composer create-project --no-interaction
    ahoy d4d up
    ```
    
    ### Use with an existing project
    
    ```bash
    cd /path/to/your/project
    l3d
    composer update
    ```