The Apigee Registry API allows teams to upload and share machine-readable descriptions of APIs that are in use and development.
This repository holds experimental code that builds on the Registry API: new projects, suspended projects, and work that might be useful in future projects.
cmd/registry-experimental contains a command-line tool that is structurally identical to the registry tool but containing experimental capabilities, some of which might eventually be migrated to the registry tool.
cmd/registry-graphql contains a simple proxy that
provides a read-only GraphQL interface to the Registry API. It can be run with
a local or remote registry-server.
We publish the Registry Server, Registry Viewer and Registry Envoy proxy docker images to GitHub Packages. We have published a sample docker-compose.yml file to make it easier to set this up on your local environment.
Steps to run this setup:
-
Run the
docker compose upcommand to start the server. -
Point your registry configuration at your local instance.
registry config configurations create local registry config set registry.address localhost:9999 registry config set registry.insecure true
-
Sample commands to create a project and a sample API.
registry rpc admin create-project --project_id=project1 registry rpc create-api --api_id=api1 --parent=projects/project1/locations/global registry rpc list-apis --parent=projects/project1/locations/global --json -
To wipe out the local setup run
docker compose down -v
This software is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
This is not an official Google product. Issues filed on Github are not subject to service level agreements (SLAs) and responses should be assumed to be on an ad-hoc volunteer basis.
Contributions are welcome! Please see CONTRIBUTING for notes on how to contribute to this project.