This file allows you to create a GitHub Actions workflow that can be triggered manually. When triggered, this workflow will run the Ampersand Patch Helper for you. The files generated are compatible with the Magento 2 Upgrade GUI.
It will save you the hassle of having 2 vendor folders (and PHPStorm indexing both 🫨), installing the Ampersand Patch Helper locally, and executing all related commands.
- Place the
create-patch-helper-files.yml
in your.github/workflows
folder. - Commit the file to your repository.
- When this file becomes available in your master/main branch, you are done!
- On your local machine, execute the Magento update through Composer. Update whatever is required (extensions, themes, etc). Push this branch to GitHub.
- Open your repository and go to
Actions > Create patch helper files
. ClickRun Workflow
and select your new branch.
![image](https://private-user-images.githubusercontent.com/5858697/327085469-5785ac74-b7e7-4e4e-ac57-4237c1807b9b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjE2NTc4NzAsIm5iZiI6MTcyMTY1NzU3MCwicGF0aCI6Ii81ODU4Njk3LzMyNzA4NTQ2OS01Nzg1YWM3NC1iN2U3LTRlNGUtYWM1Ny00MjM3YzE4MDdiOWIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcyMiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MjJUMTQxMjUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MjEyMTg0NmVkNGE3NDI0MzJlNzliYzI0NTJhODhiMjcxYjU3NWJmMGIyZGIyZDAxOTFlZTFmNWQ5ZGI3Y2FmYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.5h6A2vGim1l5VAfiiQ2Qzvmw6xT1BmgaveLv-D9hn-M)
![image](https://private-user-images.githubusercontent.com/5858697/327086566-55723f97-7cd5-48dd-91c7-e994d212085a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjE2NTc4NzAsIm5iZiI6MTcyMTY1NzU3MCwicGF0aCI6Ii81ODU4Njk3LzMyNzA4NjU2Ni01NTcyM2Y5Ny03Y2Q1LTQ4ZGQtOTFjNy1lOTk0ZDIxMjA4NWEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDcyMiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA3MjJUMTQxMjUwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NTEzOTMzOTRjNThhMjNiNzcwOGMyZjc3OTRlYWM3N2U4ODM3N2E5NDY4NDY3ZjAzMGRkODdkMmEzYzg0ZmYyNiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.5BKJ46SpbnrkpgpmltzOosjEDjr_pxjgf6SkHYpf6II)
- Extract the files and inspect the contents of
patch-helper-output.txt
. - Extract the files and place them in your project. Open Magento 2 Upgrade GUI and point it to your project. You might also need to extract the
vendor.tar.gz
andvendor_orig.tar.gz
files too.