DDEV DDEV-Live Tutorials, 1 Dec 2020

Previous Meeting

Next Meeting

⏯

youtube image

►

From YouTube: DDEV-Live Preview Feature

Description

Get all the links and commands at https://www.ddev.com/ddev-live/watch-ddev-live-preview-feature/

In the screencast we:
Create a site from a running DDEV-Local project
Wait for the site creation to complete.
Push the user-generated files up to the new site
Push the database (from the local project) up
Wait for the pushes to complete and then verify the new site.
Create a new branch and add some new code in the DDEV-Local project. In this case we're adding a theme by doing ddev composer require drupal/vani
Add the code, make a commit, push the new branch, and create a pull request.
The DDEV-Live bot immediately gives us instructions on the PR, suggesting that we type /ddev-live-create-preview. Do it, and a preview site is created.
Verify that the new theme is available and enable it on the preview site.
When done, pull the pull request and note that DDEV-Live automatically deletes the preview site.

A

Hi, my name is randy fay, I'm the maintainer of the ddev local tool, and I wanted to show you a feature that I just got my hands on the other day and tried out and really liked it in dev live dwb live is ddev's hosting managed hosting product, and this is a pretty nice little deal. The preview feature where, in a pull request, you can just automatically have it make a site out of that pull request.

A

So it copies your main site and makes a a preview url for it, so that you can show it to colleagues, collaborators customers, whoever you need to show it to it's really nice, it's a full-blown site that you can access, so we're going to we're going to give that a shot.

A

First of all, what is dev live a managed hosting service from dw. It uses git ops. So it's based around git. You do a push to github or a push to git lab and you get an updated website. That's just the way. The thing normally works and it does a composer install for you and it supports drupal, typo3 and wordpress and more coming in the future, of course.

A

Okay. So the new dwevlife preview feature, though uh you often have to show others the result of their code changes and with the preview feature, a developer's pull request can immediately become a working url. Well, it takes a minute or two, but it's uh it's fun and easy.

A

So here's what we're going to do we're going to create a drupal 9 site from a working, dwb local site whose code is on github, then we're going to create a pr with new code, we'll just make it we'll just add a theme to it and then we're going to use the the command on the github issue.

A

The dwev live preview site to create a preview site. So let's get started so first of all, we're going to look at the the site that we have and see if it's working. So let's take a quick look here.

A

This is here's the repo it's rfa d9 demo, and here is the.

A

Here's our site, everything seems to be working fine on it, so we'll just go with that.

A

Now we're going to use uh this is a long command and sometimes I stumble on it. So, let's see how I do: data of live, create site, drupal, d9, demo, drupal version branch, doc root, run, composer, install and the github repo. So let's see if I can type that.

A

So dwf live create site through full d9 demo dash dash branch equals main dash dash dock route equals web drupal builds like this are usually in the web directory. um Drupal version equals nine.

A

Run composer install and github.

A

A

D9 demo, okay, did I get all the pieces there by the way, there's help for this data data live command, so you can just type ddevlive help and at every point like if you're doing dwell live, create site drupal, you can just type that and it'll give you help so that you can see all the options that you might need.

A

A

Yup, it says branch will be deprecated in a future release, so there it is started now we can do a dwev live describe site. P9, demo and it'll show us that it's got lots of work to do so. I'm going to pause here for just a couple of minutes and then we'll come back when it's ready.

A

Okay, I let that sit for a couple of minutes so that we could get it all caught up now. If I do adidas live list sites, I should see it and it's got a preview url, which means that it's ready so I'll click on it and you see it wants to install. But what we're going to do is we're going to take my local and push the artifacts up to it so that we we don't have to do an install or anything like that there.

A

So I am going to dump the database from my dwev local site d. Div export db, dash dash file equals dot, tar balls, d9 demo.sql, so I'm just going to export from the local project, and now I am going to let's just take a look. Make sure that I don't get ahead of myself. We waited for our site creation, now we're going to push the files and we're going to push the database.

A

So let's go into web sites default files and I'm going to do a ddev live push files, d9, demo, dot, slash.

A

So there it goes.

A

Okay, now that's all pushed up. We, we really should look at the state of the restore, because that isn't actually done yet it's pushed up, but the you see that the restore is in progress, but let's just get the uh get the database up uploaded while we're here and I'm going to do. A ddev live push db, d9 demo and d9 demo dot.

A

Sql.Gz and that one uh will take a little while to restore too so I'm going to pause for a minute and we'll come back when those are finished.

A

Let's check and see if they're finished, ddev live list restores and we see that the database restore is done and that the files restore is also done so we should have.

A

We should have the exact same thing that we were working on in detail: local now up in dwev live. So, let's click the link.

A

A

And there it is same exact thing: d9 demo, it's all set, so we have it now running in ddev live so we created our whole dwev live site. um We we got the code up. There got the code from from github.

A

We waited for the site to get up. We pushed the files, pushed the databases, the database and now everything's ready. So now what we're going to do is indeed have local on our local project. We're going to just create a new branch and all I'm going to do is add a add, a theme to it and then we're going to add that to git and push the branch and create a pr. So let's see, if we can do that, so I'm going to check out a new.

A

A

So here I am ready to do that. uh My d, my local dwarf project, is still working and I'm going to do a ddev composer require drupal, slash, vani and vani is just the first theme I ran across to try to try to do it.

A

A

Okay and now it's added to the added to the composer.json and the.

A

A

Okay, so now we have the vanity theme in there and we're going to push that up to a pr.

A

And here's the pr creation link, so I'm just going to click that.

A

And I'm not going to add anything particular about it here, I'm just going to create a pull request that has that code in.

A

It and you see that ddev live has already commented on the issue that says that I can do these commands. I can do a help, which is basically is what we see right now. I can do a preview site and I can do a a delete preview site. So I'm just going to do a ddiv live preview.

A

Site and you see that the dw live bot responds immediately saying that it's creating it and it will come back with another comment when it's when it's ready uh it'll take a couple of minutes. So I'm going to pause now and I'll be back in a couple of minutes. Okay, it's completed! Now you see it's made a couple of comments as it went along. It said cloning site database still in progress cloning database and then it finally comes up with one that says: here's the preview url. So let's go to the preview url.

A

And this is a complete copy of the site that we were working on, but this one has new code. It has the theme in it. So let's just log in here.

A

And we will go to appearance.

A

And we should see vani 8.x 1.2 is available, so I'm going to install it and set it as default.

A

And now, if we go back to the site, we'll see the big mess that is an unconfigured vanity. So here's our this is our pr that shows everything that we wanted to show.

A

Let me go to the main front page, which has even more of a mess with this banny theme, trying to sell something but there's our original stuff with the new uh with a new theme and we've got it, we've got it going now. We still have if we go over here to the terminal.

A

We do a list sites and we still have the original site. It's still going, it's just fine and we also have the pr2 site. So here's the original one still sitting there untouched. Nothing has changed about it and here's the one that goes with our pr and you can even see that in the url here. So that's good. um Let's see what else we have to do. We've done everything. We've created a pr, we see the new site and we created the preview.

A

Now, let's pull this because we've decided that it's fine, so I'm going to say, merge, pull.

A

Request and you'll see that dwb live bot is right there on the on the job and it just deleted the preview site, and it's done so it it did everything that we would ask it to and really very easy to do so anyway. This is all up. This is live. This is uh this is in production. You can use this with any dwev live site today.

A

Go to docs.dev.com for the for the instructions and uh we'd love to have you sign up for a free trial of dev live at dwev.com live. So thank you very much.