mildly clean up api configs

Author: michaelkedar

deployment/api/oss-vdb/api_config_staging.yaml

@@ -2,34 +2,14 @@
 
 The API server runs on Cloud Run with Cloud Endpoints.
 
-# API server updates (backend)
+The Cloud Endpoints configuration is managed through terraform.
 
-If the backend code (i.e. server.py) code is changed, follow these steps:
-
-Pick a TAG to use for the build (base this on the date. e.g. date +"%Y%m%d")).
-
-Note: You may need to run `gcloud auth configure-docker` the first time you run
-this. See also
-https://cloud.google.com/container-registry/docs/advanced-authentication#gcloud-helper
-
-## Staging
-
-```
-./deploy_backend oss-vdb $(date +"%Y%m%d") osv-grpc-backend-staging
-```
-
-## Production
-
-```
-./deploy_backend oss-vdb $(date +"%Y%m%d") osv-grpc-backend
-```
-
-## oss-vdb-test Project
-
-Automatically built and deployed on pushes to master branch.
+Deployments of API backend is done through Cloud Deploy (`deployment/clouddeploy/osv-api`).
 
 # Contributing:
 
+Note: Running the API locally (via `make run-api-server` and `make api-server-tests`) requires GCP authentication to fetch the configuration from the `oss-vdb` project. See also `v1/README.md`.
+
 ## Writing tests
 To speed up running tests:
 

deployment/staging.yaml

@@ -25,29 +25,22 @@ python3 -m grpc_tools.protoc \
 ```
 
 ## Deploy service proxy
-To deploy the service proxy,
 
-### Test
-```
-../deploy_service_proxy oss-vdb api-test.osv.dev osv-grpc-v1-test /path/to/api_config_test.yaml
-```
+Deployment is handled through terraform.
 
-### Staging
-```
-../deploy_service_proxy oss-vdb api-staging.osv.dev osv-grpc-v1-staging /path/to/api_config_staging.yaml
-```
+`api_descriptor.pb` is symlinked to inside `deployment/terraform/environments/oss-vdb[-test]/api/`,
+Make any desired changes to `api_config.tftpl` in same folder.
 
-### Production
+`terraform plan` and `terraform apply` are automatically run on `oss-vdb-test` on pushes to the master branch.
 
-```
-../deploy_service_proxy oss-vdb api.osv.dev osv-grpc-v1 /path/to/api_config.yaml
-```
+For `oss-vdb`, terraform is run as part of the weekly release process.
 
-### oss-vdb-test Project
+## Deploy endpoints configuration for integration tests
 
-Deployment is handled through terraform.
+The Cloud Endpoints service that is required for the unit tests to run is **not** automatically deployed (to allow for testing of proto changes). The testing service is `api-test.osv.dev` on the `oss-vdb` project.
 
-`api_descriptor.pb` is symlinked to inside `deployment/terraform/environments/oss-vdb-test/api/`,
-Make any desired changes to `api_config.tftpl` in same folder.
+The configuration for this service is located in this directory `api_config_test.yaml`. To deploy changes, use the following command:
 
-`terraform plan` and `terraform apply` are automatically run on pushes to the master branch.
+```sh
+gcloud endpoints services deploy api_descriptor.pb api_config_test.yaml --project=oss-vdb
+```