Skip to content
This repository was archived by the owner on Jul 14, 2026. It is now read-only.

Commit a6c42fc

Browse files
committed
Add docs for releasing
1 parent 48ceee7 commit a6c42fc

1 file changed

Lines changed: 51 additions & 0 deletions

File tree

docs/releasing.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
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

Comments
 (0)