Bazel Codelab

Before you get started

Take a look at these informational slides to learn about Bazel.

Section 1: Hello, Bazel!

1. Edit: java/src/main/java/bazel/bootcamp/BUILD
2. Add a java_binary target for the HelloBazelBootcamp.java file
   • java_binary documentation
3. Run the binary using bazel run //java/src/main/java/bazel/bootcamp:HelloBazelBootcamp

Section 2: Go server

1. Edit the BUILD file for logger.proto

   • proto_library documentation
   • go_proto_library documentation
   Hint

   Check out the compilers attribute for go_proto_library in the grpc example
   Hint

   Go libraries each declare the import path at which they would like to be imported by other go files. server.go imports the proto file at bootcamp/proto/logger so the importpath attribute of go_proto_library should match that.

2. Edit the BUILD file for server.go

   • go_binary documentation

3. Run the go binary using bazel run

4. Go to http://localhost:8081 to see results (there won't be any logs yet)

Section 3: Java client

1. Edit the BUILD file for logger.proto
   • java_proto_library documentation
   • java_grpc_library documentation (look towards the bottom of the page for Bazel related documentation)
2. Edit the BUILD file for JavaLoggingClientLibrary.java
   • java_library documentation
3. Edit the BUILD file for JavaLoggingClient.java
   • java_binary documentation
4. bazel run the Java binary you wrote
5. bazel run the Go binary from Section 2
6. Send messages from the client to the server and view them on http://localhost:8081

Section 4: Java client unit tests

1. Edit the BUILD file for JavaLoggingClientLibraryTest.java
   • java_test documentation
   Hint

   Names matter for tests. The java_test for this file should be named JavaLoggingClientLibraryTest
2. Edit the BUILD file for JavaLoggingClientTest.java
3. Run the tests using bazel test

Section 5: Typescript web frontend

1. Edit the WORKSPACE to uncomment the typescript relevant portions
2. Edit the BUILD file for logger.proto
   • ts_proto_library documentation
3. Edit the BUILD file for app.ts
   • ts_library usage example and ts_library documentation
4. Run the webserver using bazel run. It will print out a link which you can click on. If the link doesn't work, go to http://localhost:8080 instead
5. Run the Go server and Java client from the previous steps. Send messages from the Java client to the Go server and see them appear on the web frontend

Section 6: Integration test

1. Edit the BUILD file for integrationtest.sh
   • sh_test documentation
2. Run the test using bazel test and make sure that it passes
3. Run the test using bazel test <target> --runs_per_test=10 and make sure that it passes
   Hint

   You may need to modify the BUILD file again to make this work

Section 7: Query

1. https://docs.bazel.build/versions/master/query-how-to.html