mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-09-10 14:11:42 +00:00
77 lines
2.3 KiB
Markdown
77 lines
2.3 KiB
Markdown
# ADF Patch Release
|
|
|
|
**Below steps describe how to create a patch release for latest ADF version**
|
|
|
|
1. Patching ADF starts from master branch, therefore you need to be sure you have the latest master branch:
|
|
|
|
```bash
|
|
git checkout master
|
|
git pull
|
|
```
|
|
|
|
2. Learn the version you would like to patch, you can check ADF versions [here](https://github.com/Alfresco/alfresco-ng2-components/tags).
|
|
|
|
3. Create new patch branch from master i.e. **develop-patch-VERSION** (e.g. develop-patch-4.11.1):
|
|
|
|
```bash
|
|
git checkout -b develop-patch-VERSION master
|
|
```
|
|
|
|
4. Apply and commit your fix to **develop-patch-VERSION** branch.
|
|
|
|
5. Increment the version in the package.json with the following command where `-v` refers to the ADF version and `-vj` to the new js-api version.
|
|
The js-api must have a major version that is one higher than the other packages. For example, if adf-core is at version `4.11.1`, then js-api should be at version `5.11.1`
|
|
|
|
```bash
|
|
./scripts/update-version.sh -v X.X.X -vj X.X.X
|
|
|
|
# e.g. ./scripts/update-version.sh -v 4.1.11 -vj 5.1.11
|
|
```
|
|
6. The `"@alfresco/js-api"` dependency in the `lib/cli/package.json` has to remain unchanged
|
|
|
|
7. Run [release.sh](../../scripts/release.sh) script with proper patch version:
|
|
|
|
```bash
|
|
scripts/release.sh -v VERSION
|
|
|
|
# e.g. scripts/release.sh -v 4.11.1
|
|
```
|
|
8. Push your changes and run all tests:
|
|
|
|
```bash
|
|
git push -u origin develop-patch-VERSION
|
|
```
|
|
|
|
In order to run all tests you can use **[ci:force]** flag:
|
|
|
|
```bash
|
|
git commit -m '[ci:force]' --allow-empty
|
|
git push
|
|
```
|
|
|
|
9. Verify if tests are green and if everything looks fine, you can proceed further.
|
|
|
|
10. Create new branch from **master** and call it **master-patch-VERSION** (e.g. master-patch-4.11.1):
|
|
|
|
```bash
|
|
git checkout master
|
|
git checkout -b master-patch-VERSION
|
|
```
|
|
|
|
11. Merge **develop-patch-VERSION** into **master-patch-VERSION**:
|
|
|
|
```bash
|
|
git checkout master-patch-VERSION
|
|
git merge develop-patch-VERSION
|
|
```
|
|
|
|
12. Push **master-patch-VERSION** branch:
|
|
|
|
```bash
|
|
git push -u origin master-patch-VERSION
|
|
```
|
|
|
|
13. Verify if build is green and check if proper [tag](https://github.com/Alfresco/alfresco-ng2-components/tags) was created.
|
|
|
|
14. After all is done, you can **cherry-pick** your fix to develop.
|