|
| 1 | +--- |
| 2 | +title: "Releasing Phoenix in oCIS" |
| 3 | +weight: 25 |
| 4 | +geekdocRepo: https://github.com/owncloud/phoenix |
| 5 | +geekdocEditPath: edit/master/docs |
| 6 | +geekdocFilePath: building.md |
| 7 | +--- |
| 8 | + |
| 9 | +{{< toc >}} |
| 10 | + |
| 11 | +## Releasing Phoenix |
| 12 | + |
| 13 | +The next generation Web Frontend is shipped as an ocis Extension. The `ocis-phoenix` extension is also embedded in the single binary and part of the `ocis server` command. |
| 14 | + |
| 15 | +To update this package within all the deliveries, we need to update the package in the following chain from the bottom to the top. |
| 16 | + |
| 17 | +### Package Hierarchy |
| 18 | + |
| 19 | +```markdown |
| 20 | +- [ ] [ocis](https://githug.com/owncloud/ocis) |
| 21 | + - [ ] [ocis-phoenix](https://github.com/owncloud/ocis-phoenix) |
| 22 | + - [ ] [ocis-pkg](https://github.com/owncloud/ocis-pkg) |
| 23 | + - [ ] [phoenix](https://github.com/owncloud/phoenix) |
| 24 | +``` |
| 25 | + |
| 26 | +#### Releasing Phoenix Frontend |
| 27 | + |
| 28 | +1. Create a branch `release-$version`. in <https://github.com/owncloud/phoenix> |
| 29 | +2. Create a Folder in `changelog` for the release version and date `mkdir $major.$minor.$patchVersion_YYYY-MM-DD`. |
| 30 | +3. Move all changelog items from the `changelog/unreleased/` folder to the `$major.$minor.$patchVersion_YYYY-MM-DD` folder. |
| 31 | +4. Commit your changes. |
| 32 | +5. After merging, wait for the CI to run on the merge commit. |
| 33 | +6. Go to "Releases" in GH click "Draft a new Release". |
| 34 | +7. Use `v$major.$minor.$patch` as a tag (the `v` prefix is important) and publish it. |
| 35 | +8. The tag and the Release artifacts will be created automatically. |
| 36 | + |
| 37 | +#### Updating ocis-phoenix |
| 38 | + |
| 39 | +1. Create a branch `release-$version`. in <https://github.com/owncloud/ocis-phoenix> |
| 40 | +2. Create a Folder in `changelog` for the release version and date `mkdir $major.$minor.$patchVersion_YYYY-MM-DD`. |
| 41 | +3. Move all changelog items from the `changelog/unreleased/` folder to the `$major.$minor.$patchVersion_YYYY-MM-DD` folder. |
| 42 | +4. Update the go module `ocis-pkg` to the latest version <https://blog.golang.org/using-go-modules> . |
| 43 | +5. Update the phoenix asset in the Makefile. |
| 44 | +6. Create Changelog item for the Update in the `$major.$minor.$patchVersion_YYYY-MM-DD` folder. |
| 45 | +7. Commit your changes. |
| 46 | +8. After merging, wait for the CI to run on the merge commit. |
| 47 | +9. Go to "Releases" in GH click "Draft a new Release". |
| 48 | +10. Use `v$major.$minor.$patch` as a tag (the `v` prefix is important) and publish it. |
| 49 | +11. The tag and the Release artifacts will be created automatically. |
| 50 | + |
| 51 | +#### Updating the embedded ocis root command |
0 commit comments