awesome-bookmarks/goose
3
0
Fork 0
mirror of https://github.com/block/goose.git synced 2026-07-17 12:56:20 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: pin version in ci/cd (#7168)

Browse Source
This commit is contained in:
dianed-square
2026-02-11 17:24:37 -08:00
committed by GitHub
parent f96d38e382
commit 7f0af1be52
3 changed files with 21 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/docs/getting-started/installation.md
+5
View File
@@ -402,6 +402,11 @@ While core configurations are shared between interfaces, extensions have flexibi
</TabItem>
</Tabs>
## Pin a goose version in CI/CD
In CI/CD (and other automated, non-interactive environments), pin a specific version with `GOOSE_VERSION` to make installs reproducible and avoid 404s when downloading the goose CLI binary assets if the `stable` release tag doesn’t include them.
See [CI/CD Environments](/docs/tutorials/cicd) for a complete example and usage details.
## Additional Resources
You can also configure Extensions to extend goose's functionality, including adding new ones or toggling them on and off. For detailed instructions, visit the [Using Extensions Guide][using-extensions].
documentation/docs/guides/updating-goose.md
+4
View File
@@ -162,3 +162,7 @@ The goose CLI and desktop apps are under active and continuous development. To g
</Tabs>
</TabItem>
</Tabs>
:::info Updating in CI/CD
If you're running goose in CI or other non-interactive environments, pin a specific version with `GOOSE_VERSION` for reproducible installs. See [CI/CD Environments](/docs/tutorials/cicd) for a complete example and usage details.
:::
documentation/docs/tutorials/cicd.md
+12 -3
View File
@@ -69,7 +69,7 @@ jobs:
run: |
mkdir -p /home/runner/.local/bin
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh \
| CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
| GOOSE_VERSION=REPLACE_WITH_VERSION CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
echo "/home/runner/.local/bin" >> $GITHUB_PATH
- name: Configure goose
@@ -159,7 +159,7 @@ steps:
run: |
mkdir -p /home/runner/.local/bin
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh \
| CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
| GOOSE_VERSION=REPLACE_WITH_VERSION CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
echo "/home/runner/.local/bin" >> $GITHUB_PATH
- name: Configure goose
@@ -172,8 +172,17 @@ steps:
EOF
```
#### Pinning goose versions in CI/CD
In CI/CD, we recommend pinning a specific goose version with `GOOSE_VERSION` for reproducible runs. This also avoids 404 errors when downloading the goose CLI binary assets if the `stable` release tag doesn’t include them.
Relevant installer options for CI:
- `GOOSE_VERSION`: the version to pin the install to (both `1.21.1` and `v1.21.1` formats are supported)
- `GOOSE_BIN_DIR`: install directory (make sure this directory is on `PATH`)
- `CONFIGURE=false`: skip interactive `goose configure` flow
:::info Replacements
Replace `REPLACE_WITH_PROVIDER` and `REPLACE_WITH_MODEL` with your LLM provider and model names and add any other necessary configuration required.
Replace `REPLACE_WITH_VERSION`, `REPLACE_WITH_PROVIDER`, and `REPLACE_WITH_MODEL` with the goose version you want to pin and your LLM provider/model names. Add any other necessary configuration required.
:::
### 4. Gather PR Changes and Prepare Instructions