mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-01-10 07:58:12 -05:00

Files

Yuan 9ecf1755ab docs: update render-heading hook (#649 )

There's a `no such template "_default/_markup/td-render-heading.html"`
error when running `hugo server` locally. This is due to a breaking
change in [Hugo
v0.146.0](https://github.com/gohugoio/hugo/releases/tag/v0.146.0). This
PR updates the render-heading file according to
https://github.com/google/docsy/pull/2223.

2025-06-04 01:14:23 +00:00

4.8 KiB

Raw Blame History

DEVELOPER.md

Before you begin

Make sure you've setup your databases.
Install the latest version of Go.
Locate and download dependencies:
```
go get
go mod tidy
```

Developing Toolbox

Run Toolbox from local source

Create a tools.yaml file with your sources and tools configurations.
You can specify flags for the Toolbox server. Execute the following to list the possible CLI flags:
```
go run . --help
```
To run the server, execute the following (with any flags, if applicable):
```
go run .
```
The server will listen on port 5000 (by default).
Test endpoint using the following:
```
curl http://127.0.0.1:5000
```

Testing

Run the lint check:
```
golangci-lint run --fix
```
Run unit tests locally:
```
go test -race -v ./...
```
Run integration tests locally:
1. Set required environment variables. For a complete lists of required vairables for each source, check out the Cloud Build testing configuration.
  - Use your own GCP email as the SERVICE_ACCOUNT_EMAIL.
  - Use the Google Cloud SDK application Client ID as the CLIENT_ID. Ask the Toolbox maintainers if you don't know it already.
2. Run the integration test for your target source with the required Go build tags specified at the top of each integration test file:
```
    go test -race -v ./tests/<YOUR_TEST_DIR>
```
  For example, to run the AlloyDB integration test, run:
```
    go test -race -v ./tests/alloydbpg
```
Run integration tests on your PR:

For internal contributors, the testing workflows should trigger automatically. For external contributors, ask the Toolbox maintainers to trigger the testing workflows on your PR.

Compile the app locally

Compile Toolbox binary

Run build to compile binary:
```
go build -o toolbox
```
You can specify flags for the Toolbox server. Execute the following to list the possible CLI flags:
```
./toolbox --help
```
To run the binary, execute the following (with any flags, if applicable):
```
./toolbox
```
The server will listen on port 5000 (by default).
Test endpoint using the following:
```
curl http://127.0.0.1:5000
```

Compile Toolbox container images

Run build to compile container image:
```
docker build -t toolbox:dev .
```
Execute the following to view image:
```
docker images
```
Run container image with Docker:
```
docker run -d toolbox:dev
```

Developing Documentation

Install Hugo version 0.146.0+.
Move into the .hugo directory
```
cd .hugo
```
Install dependencies
```
npm ci
```
Run the server
```
hugo server
```

Developing Toolbox SDKs

Please refer to the SDK developer guide

(Optional) Maintainer Information

Releasing

There are two types of release for Toolbox, including a versioned release and continuous release.

Versioned release: Official supported distributions with the latest tag. The release process for versioned release is in versioned.release.cloudbuild.yaml.
Continuous release: Used for early testing features between official supported releases and end-to-end testings.

Supported OS and Architecture binaries

The following OS and computer architecture is supported within the binary releases.

linux/amd64
darwin/arm64
darwin/amd64
windows/amd64

Supported container images

The following base container images is supported within the container image releases.

distroless

Automated tests

Integration and unit tests are automatically triggered via CloudBuild during each PR creation.

Trigger Setup

Create a Cloud Build trigger via the UI or gcloud with the following specs:

Event: Pull request
Region:
- global - for default worker pools
Source:
- Generation: 1st gen
- Repo: googleapis/genai-toolbox (GitHub App)
- Base branch: ^main$
Comment control: Required except for owners and collaborators
Filters: add directory filter
Config: Cloud Build configuration file
- Location: Repository (add path to file)
Service account: set for demo service to enable ID token creation to use to authenticated services

Trigger

Trigger the PR tests on PRs from external contributors:

Cloud Build tests: comment /gcbrun
Unit tests: add tests:run label

4.8 KiB Raw Blame History