pipelines/backend
IronPan 36338774f1
update the API doc description (#1410)
* add single json file

* update doc

* update doc
2019-05-31 13:31:33 -07:00
..
api update the API doc description (#1410) 2019-05-31 13:31:33 -07:00
src Fix API package names and regenerate checked-in proto files. (#1404) 2019-05-30 11:26:28 -07:00
test Fix API package names and regenerate checked-in proto files. (#1404) 2019-05-30 11:26:28 -07:00
Dockerfile Fix API package names and regenerate checked-in proto files. (#1404) 2019-05-30 11:26:28 -07:00
Dockerfile.persistenceagent expose namespace config for persistent agent (#1308) 2019-05-10 13:20:16 -07:00
Dockerfile.scheduledworkflow expose namespace config for scheduled workflow (#1309) 2019-05-10 14:08:12 -07:00
Dockerfile.viewercontroller expose configuration for setting the max number of tensorboard (#1393) 2019-05-28 13:18:58 -07:00
OWNERS Updating OWNERS files. Adding per-subdirectory OWNER files. 2018-11-05 14:03:33 -08:00
README.md Add fake metadata store and fix tests. (#958) 2019-03-21 00:57:35 -07:00

README.md

This directory contains code for the components that comprise the Kubeflow Pipelines backend.

Building & Testing

All components can be built using Bazel. To build everything under backend, run:

bazel build --action_env=PATH --define=grpc_no_ares=true //backend/...

To run all tests:

bazel test --action_env=PATH --define=grpc_no_ares=true //backend/...

The API server itself can only be built/tested using Bazel. The following commands target building and testing just the API server.

bazel build --action_env=PATH --define=grpc_no_ares=true backend/src/apiserver/...
bazel test --action_env=PATH --define=grpc_no_ares=true backend/src/apiserver/...

Building Go client library and swagger files

After making changes to proto files, the Go client libraries and swagger files need to be regenerated and checked-in. The backend/api/generate_api.sh script takes care of this.

Updating BUILD files

As the backend is written in Go, the BUILD files can be updated automatically using Gazelle. Whenever a Go file is added or updated, run the following to ensure the BUILD files are updated as well:

bazel run //:gazelle

If a new external Go dependency is added, or an existing one has its version bumped in the go.mod file, ensure the BUILD files pick this up by updating the WORKSPACE go_repository rules using the following command:

bazel run //:gazelle -- update-repos --from_file=go.mod