docs: RELEASING uses gt instead of the archived tea
This commit is contained in:
1 parent
7f6b598c4a
commit
812d8d7ea5
1 file changed
+13
-12
+13
-12
@@ -86,6 +86,11 @@ scratch vault/config — never against the real `~/.onyx-cli/config.yaml`.
|
|||||||
> **Windows gotcha**: the plain bash tool can't execute a freshly built
|
> **Windows gotcha**: the plain bash tool can't execute a freshly built
|
||||||
> `.exe` directly (`command not found`) — always invoke it through
|
> `.exe` directly (`command not found`) — always invoke it through
|
||||||
> `cmd.exe /c "onyx.exe ..."`.
|
> `cmd.exe /c "onyx.exe ..."`.
|
||||||
|
>
|
||||||
|
> **Linux scratch config**: run the smoke as a script file
|
||||||
|
> (`wsl -d Ubuntu-24.04 -- bash smoke.sh`), and save the binary path
|
||||||
|
> (`B=$HOME/onyx-build/dist/onyx`) before pointing `HOME` at a scratch
|
||||||
|
> directory, so the real config stays untouched.
|
||||||
|
|
||||||
## 5. Deploy locally (optional)
|
## 5. Deploy locally (optional)
|
||||||
|
|
||||||
@@ -129,33 +134,29 @@ git push origin vX.Y.Z
|
|||||||
|
|
||||||
## 7. Create the Gitea release
|
## 7. Create the Gitea release
|
||||||
|
|
||||||
`tea` hangs indefinitely under a plain non-interactive shell call, for
|
Use `gt` (gitea-cli 1.0+; `tea` is archived). `gt` never pushes, so step 6
|
||||||
*any* subcommand, including fully local ones. Always launch it as a
|
must be done first; `--verify-tag` refuses a tag the server doesn't have.
|
||||||
supervised process (hub `start`/`wait`/`logs`), never via the bash tool
|
From the bash tool, invoke it through `cmd.exe /c` like the exe above.
|
||||||
directly.
|
|
||||||
|
|
||||||
Write release notes to a scratch file, then create the release with both
|
Write release notes to a scratch file, then create the release with both
|
||||||
assets in one call:
|
assets in one call:
|
||||||
|
|
||||||
```
|
```
|
||||||
tea releases create --repo olivier/onyx-cli --tag vX.Y.Z --title vX.Y.Z \
|
gt release create vX.Y.Z dist/onyx.exe dist/onyx-linux --title vX.Y.Z \
|
||||||
--note-file release-notes-vX.Y.Z.md -a dist/onyx.exe -a dist/onyx-linux
|
--notes-file release-notes-vX.Y.Z.md --verify-tag --no-input
|
||||||
```
|
```
|
||||||
|
|
||||||
If the release already exists and you're adding a platform binary later
|
If the release already exists and you're adding a platform binary later
|
||||||
(e.g. the Linux build wasn't ready yet), attach it separately instead:
|
(e.g. the Linux build wasn't ready yet), attach it separately instead
|
||||||
|
(`--clobber` replaces an asset with the same name):
|
||||||
|
|
||||||
```
|
```
|
||||||
tea releases assets create --repo olivier/onyx-cli vX.Y.Z dist/<file>
|
gt release upload vX.Y.Z dist/<file>
|
||||||
```
|
```
|
||||||
|
|
||||||
Delete the scratch release-notes file afterward — it's not a repo
|
Delete the scratch release-notes file afterward — it's not a repo
|
||||||
convention file.
|
convention file.
|
||||||
|
|
||||||
> `tea repos create --owner olivier` fails with `GetOrgByName` — `--owner`
|
|
||||||
> targets an organization, not your personal account. Omit it entirely
|
|
||||||
> when creating a repo under your own user.
|
|
||||||
|
|
||||||
## 8. Verify the release
|
## 8. Verify the release
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
Reference in new issue
Block a user