44 lines
1.6 KiB
Markdown
44 lines
1.6 KiB
Markdown
|
# Internal
|
||
|
|
|
||
|
|
This directory contains internal code for cloud.google.com/go packages.
|
||
|
|
|
||
|
|
## .repo-metadata-full.json
|
||
|
|
|
||
|
|
`.repo-metadata-full.json` contains metadata about the packages in this repo. It
|
||
|
|
is generated by `internal/gapicgen/generator`. It's processed by external tools
|
||
|
|
to build lists of all of the packages.
|
||
|
|
|
||
|
|
Don't make breaking changes to the format without consulting with the external
|
||
|
|
tools.
|
||
|
|
|
||
|
|
One day, we may want to create individual `.repo-metadata.json` files next to
|
||
|
|
each package, which is the pattern followed by some other languages. External
|
||
|
|
tools would then talk to pkg.go.dev or some other service to get the overall
|
||
|
|
list of packages and use the `.repo-metadata.json` files to get the additional
|
||
|
|
metadata required. For now, `.repo-metadata-full.json` includes everything.
|
||
|
|
|
||
|
|
## cloudbuild.yaml
|
||
|
|
|
||
|
|
To kick off a build locally run from the repo root:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
gcloud builds submit --project=cloud-devrel-kokoro-resources --config=internal/cloudbuild.yaml
|
||
|
|
```
|
||
|
|
|
||
|
|
### Updating OwlBot SHA
|
||
|
|
|
||
|
|
You may want to manually update the which version of the post processor will be
|
||
|
|
used -- to do this you need to update the SHA in the OwlBot lock file. Start by
|
||
|
|
running the following commands:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker pull gcr.io/cloud-devrel-public-resources/owlbot-go:latest
|
||
|
|
docker inspect --format='{{index .RepoDigests 0}}' gcr.io/cloud-devrel-public-resources/owlbot-go:latest
|
||
|
|
```
|
||
|
|
|
||
|
|
This will give you a SHA. You can use this value to update the value in
|
||
|
|
`.github/.OwlBot.lock.yaml`.
|
||
|
|
|
||
|
|
*Note*: OwlBot will eventually open a pull request to update this value if it
|
||
|
|
discovers a new version of the container.
|