Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Blog post: Migrating Drupal 7 to Drupal 9 with Acquia Migrate: Accelerate (AM:A) #145

Merged
merged 40 commits into from
Nov 22, 2023

Conversation

RowboTony
Copy link
Contributor

The Issue

Acquia Migrate: Accelerate (AM:A) on DDEV is a powerful tool. I hope this post will help others with the migration of their old Drupal 7 site to modern Drupal.

Manual Testing Instructions

Please review the steps, and provide feedback on improvements, clarifications, proofreading, spelling. This is my first blog post anywhere. I'm new to this whole process, guidance and feedback are appreciated.

Thanks!
--Tony

Copy link
Member

@rfay rfay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is going to be a great help to people, thanks so much!

You somehow accidentally deleted the .ddev/config.yaml, I'm not sure how, but could you please rebase this and make sure it doesn't change anything you don't intend to change?

@rfay
Copy link
Member

rfay commented Nov 17, 2023

Oh, one other thing, could you please change the main blog filename, which becomes the URL, to be distinct words, maybe drupal7-drupal9-migration-ddev-acquia-migrate-accelerate.md ?

@rfay
Copy link
Member

rfay commented Nov 17, 2023

And "just" is not allowed because I just always overuse it, sorry, https://github.com/ddev/ddev.com/actions/runs/6908030499/job/18796913683?pr=145

@RowboTony
Copy link
Contributor Author

I am working to fix all of these issues in a new branch. I will close this PR and resubmit soon.

@RowboTony RowboTony closed this Nov 19, 2023
@rfay
Copy link
Member

rfay commented Nov 19, 2023

You don't have to do that at all - you can just push commits in here :) Let me know if you want me to reopen.

@RowboTony
Copy link
Contributor Author

Honestly, I'm still learning my way around Github. Shockingly, I've made it 20 years without really needing or using git. My repo is a bit gnarly at the moment. I'm working to clean it up and apply best practices, so I created a new branch for the blog post. I'll merge it back to main and resubmit.

@RowboTony
Copy link
Contributor Author

Regarding the config.yaml - when I rebased, it overwrote my local, so... I'm not sure if I should reconfigure my local ddev.com project? Anyhow, I won't mess with it until tomorrow.

I think I've successfully merged my d7-d9-ama-blog branch in to the main branch for this PR.. Please reopen and review at your convenience.

@RowboTony RowboTony reopened this Nov 19, 2023
@rfay
Copy link
Member

rfay commented Nov 19, 2023

Honestly, I'm still learning my way around Github. Shockingly, I've made it 20 years without really needing or using git.

Git is an absolute delight when you understand it. I'm happy to help you sort things out, ping me in Discord or whatever.

Regarding the config.yaml - when I rebased, it overwrote my local, so... I'm not sure if I should reconfigure my local ddev.com project? Anyhow, I won't mess with it until tomorrow.

Assuming you have a git remote called "upstream" and maybe your forked remote is called "origin" you can git fetch upstream and git checkout upstream/main .ddev/config.yaml to get the .ddev/config.yaml from upstream and get things back in sync.

@RowboTony
Copy link
Contributor Author

Thanks, I think I've fixed it per your guidance. This pull request now shows only the added files related to the blog post.

@tyler36
Copy link
Contributor

tyler36 commented Nov 20, 2023

@RowboTony Github has some free self-paced courses at https://skills.github.com/ which are helpful.

@rfay
Copy link
Member

rfay commented Nov 20, 2023

Thanks for all the great work! I'm hoping to be able to review this week.

Copy link
Member

@rfay rfay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Basically I think this is ready to go with minor alterations.

Questions people will ask:

  • Did you get past the 80% level? What's your path for that?
  • How can people contribute to this? Obviously they can do PRs to edit this, but do you want to have a GitHub repo or something to refer people to?

### <mark>Logout of the `ddev ssh` session</mark>, and modify the DDEV project to serve a second URL for the d9 site:

```
logout
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't even know this existed. Always use exit or <ctrl-d> - Learn something every day!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I remember being taught that logout was the best practice back in the days of the SunOS systems I was working on decades ago, and it's stuck with me since. 😁

@RowboTony
Copy link
Contributor Author

Basically I think this is ready to go with minor alterations.

Questions people will ask:

  • Did you get past the 80% level? What's your path for that?

Not yet, the site has been in stasis for a few weeks, no progress beyond the walkthrough. I'm working next on learning D9/D10 theming to finish and deploy this site.

The 80% I'm referring to is to total completion of the site to production. 100% by my definition would include; a complete new theme, themed page layouts, and new Views. It may be better if I provide clarification that 98% of the data was migrated with AM:A, and only 75% of the data was migrated with the D10 traditional method? Theme, Views, and pages layouts will need to be recreated in both scenarios regardless of migration method.

  • How can people contribute to this? Obviously they can do PRs to edit this, but do you want to have a GitHub repo or something to refer people to?

I think the best canonical source would be DDEV.com for anyone to PR and update the blog post. Considering my inexperience with git, I don't think I'd be a very good steward of a repo as I planned to delete my ddev.com fork once this was posted. I predict AM:A will begin moving very quickly, so this could also become outdated quickly. I don't plan to keep updating it myself into the future. Your thoughts or suggestions?

@rfay
Copy link
Member

rfay commented Nov 21, 2023

I will appreciate you maintaining it as time goes on.

I was saying that people will want to know in the article where you actually got to, and what your plans are (and maybe you can update this as you get farther). As you know, "80%" is a calamity in the software world because it only takes 20% of the time to get 80% complete, and the other 20% takes 80% of the time :)

Is it possible to share a link to the work-in-progress, or is it not live?

I dearly wish I had time right now to go through this with my own Drupal7 blog, randyfay.com

I'll pull this when you say it's ready.

@RowboTony
Copy link
Contributor Author

I will appreciate you maintaining it as time goes on.

I'm happy to update this as I learn more. But it's a bit of a chicken and egg situation. I'm certain that with a few more days of tinkering I can get this to work with D10, but I don't know when I'll have those days available to work on it. Also, I have a sense that many people don't yet know the power of this tool - so hopefully as the blog post gets out it can bring in others who can contribute to the direct to D10 path.

I was saying that people will want to know in the article where you actually got to, and what your plans are (and maybe you can update this as you get farther). As you know, "80%" is a calamity in the software world because it only takes 20% of the time to get 80% complete, and the other 20% takes 80% of the time :)

Very good point, I added a Next Steps closing prahraph to address this.

Is it possible to share a link to the work-in-progress, or is it not live?

Sorry, it's not live anywhere yet.

I dearly wish I had time right now to go through this with my own Drupal7 blog, randyfay.com

I'll pull this when you say it's ready.

@rfay
Copy link
Member

rfay commented Nov 22, 2023

Were you calling it ready?

@RowboTony
Copy link
Contributor Author

Were you calling it ready?

Yes, it's ready. Please publish at your convenience. This was a great experience. Thank you again for the encouragement and support!

@rfay rfay merged commit c5d8a10 into ddev:main Nov 22, 2023
1 check passed
@rfay
Copy link
Member

rfay commented Nov 22, 2023

Yay, thanks so much!

@rfay
Copy link
Member

rfay commented Nov 22, 2023

https://twitter.com/randyfay/status/1727367486130225272

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

3 participants