DDEV DDEV friends - community presentations, 9 Sep 2020

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Setup Drupal 8 with DDEV

Description

Build a local Drupal development environment with DDEV.

Learn more about Mediacurrent's training services and how we can help your team level up here: http://mediacurrent.com/training

A

Hi everyone today, I will show you how to build a drupal website for development purposes, we'll be using d-dev, which is an open source tool to build local php development environments.

A

The only requirements for getting started with the dev is to first install docker, which is a platform for developers and sys admins to build, run and share applications with containers. Once docker is installed, you need to install ddif.

A

There are a lot of resources for you to install both these applications and you can find all the details at the devsdock site. You see here we will build a composer-based drupal site. This means we will be using composer for managing all drupal dependencies, such as modules draws and others, starting with drupal 8.8 drupal core uses composer project templates, which are part of drupal core, and they are the recommended approach for building composer based drupal sites.

A

So, let's start we will actually use ddbs drupal, a quick start stray from their docs. It's pretty straightforward approach, which includes these steps shown here. So we'll follow each of those steps.

A

First, to be sure, we need to make sure that docker is up and running so ensure that that is the case before you can start now. We will create a new folder anywhere on your computer. Typically, I create my docker base websites in my site's docker folder, but you can create that anywhere. You want. I will call this folder my drupal 8 site.

A

Then I will cd into that folder by typing cd, my drupal 8 site. Next, we are going to run dev configuration to define the type of project that we are creating. Here we are setting the project as a drupal, a type project in which dtap will create a web folder for drupal to be set up in in previous composer templates. The doc root was directly in the root of the project.

A

With the new composer templates, we can set up a web folder for drupal's doc root. Now, I'm going to run ddef start to build the database and web containers. These containers need to be ready before we can install drupal and, as you can see, ddev created a settings.php and a settings.dev.php file which you can use to override any configuration coming from settings.php.

A

This way you can keep your settings.php private and protected well, you're, still able to share any custom configurations through the settings that detail the php with your team. Now it's time to install drupal. This is where we use the composer template in which we define the latest available drupal aaa version at this point in time. Typically, you will run this on an empty folder, but since there is content already in our folder, we are asked if we want to override the content. Let's accept the default obvious by pressing return.

A

This will begin to download drupal core, as well as any dependencies. This process can take a while, but I've speed up the process to spare you some of the weight. One thing about this approach is that if we create a repository of our project, we will not be committing any of the code base. We download like drupal, core or modules.

A

Instead we will only commit composer digestion and this will make our project a lot smaller.

A

Something that I really like about this composer template is that, at the end of the process after I downloaded drupal, it gives you next steps so that you can have some guidance or direction on what you can do next with your drupal site. That's pretty neat now that drupal is downloaded. Let's download rush at the beginning, I said that the only things a user need to do to install the lock machine is to install docker and d-dev.

A

This means that we don't need to install draws or composer in our local machine. We will install and run those from the containers.

A

Now, let's start drupal by running the dev launch, this will launch our application, so we can complete the drupal installation. You will notice the database configuration screen is skipped, and that is because they've created the settings.dave.php file, which is where all the data configuration is already stored.

A

There you have it a new aaa site up and running now the drupal is ready. Let's add a couple modules that we will eventually use when we start working with drupal tasks, but first, let's see how you can run rush commands in a docker container to ensure drives runs on the container and not the host machine. We need to prefix each drives command with dev exec and to make it even easier.

A

We can even do div dot and then the drush command we'll do a little more draws commands shortly for now, let's use composer to download the develop and admin toolbar modules.

A

This also is prefixed with the dev to ensure that composer runs on the container and not the host machine. By the way you can still run draws commands on your host machine. If that is something you prefer to do, if you have drawers set up locally, the advantage of using ddiv is that you don't have to have garage or composer installed on your host machine.

A

Now, let's clear our command line screen and enable the new modules using draws, then we're going to clear drupal's cache to ensure that everything is working. Fine.

A

If we go back to our drupal site and I hover over the admin toolbar, you can see, there's some drop downs and that tells us that those are coming from the admin toolbar module that we just installed. So that's it. I hope this was helpful in future videos. We will make use of our new drupal site to work on drupal related tasks like theming and development.

A

A