bazel/ci: unify developer-local and CI build generation.

WORKSPACE

@@ -3,78 +3,3 @@ workspace(name = "envoy")
 load("//bazel:repositories.bzl", "envoy_dependencies")
 
 envoy_dependencies()
-
-bind(
-    name = "ares",
-    actual = "@cares_git//:ares",
-)
-
-bind(
-    name = "cc_wkt_protos_genproto",
-    actual = "@protobuf_git//:cc_wkt_protos_genproto",
-)
-
-bind(
-    name = "cc_wkt_protos",
-    actual = "@protobuf_git//:cc_wkt_protos",
-)
-
-bind(
-    name = "event",
-    actual = "@libevent_git//:event",
-)
-
-bind(
-    name = "event_pthreads",
-    actual = "@libevent_git//:event_pthreads",
-)
-
-bind(
-    name = "googletest",
-    actual = "@googletest_git//:googletest",
-)
-
-bind(
-    name = "http_parser",
-    actual = "@http_parser_git//:http_parser",
-)
-
-bind(
-    name = "lightstep",
-    actual = "@lightstep_git//:lightstep_core",
-)
-
-bind(
-    name = "nghttp2",
-    actual = "@nghttp2_tar//:nghttp2",
-)
-
-bind(
-    name = "protobuf",
-    actual = "@protobuf_git//:protobuf",
-)
-
-bind(
-    name = "protoc",
-    actual = "@protobuf_git//:protoc",
-)
-
-bind(
-    name = "rapidjson",
-    actual = "@rapidjson_git//:rapidjson",
-)
-
-bind(
-    name = "spdlog",
-    actual = "@spdlog_git//:spdlog",
-)
-
-bind(
-    name = "ssl",
-    actual = "@boringssl//:ssl",
-)
-
-bind(
-    name = "tclap",
-    actual = "@tclap_archive//:tclap",
-)

bazel/EXTERNAL_DEPS.md

@@ -0,0 +1,18 @@
+# Adding external dependencies to Envoy
+
+1. Specify name and version in [external documentation](../docs/install/requirements.rst).
+2. Add a build recipe X in [`ci/build_container/build_recipes`](../ci/build_container/build_recipes)
+   for developer-local and CI external dependency build flows.
+3. Add the build recipe X to the list in [`bazel/recipes.bzl`](recipes.bzl).
+4. Add a build target Y in [`ci/prebuilt/BUILD`](../ci/prebuilt/BUILD) to consume the headers and
+   libraries produced by the build recipe X.
+5. Add a map from target Y to build recipe X in [`target_recipes.bzl`](target_recipes.bzl).
+6. Reference your new external dependency in some `envoy_cc_library` via Y in the `external_deps`
+   attribute.
+7. `bazel test //test/...`
+
+# Updating an external dependency version
+
+1. Specify the new version in [external documentation](../docs/install/requirements.rst).
+2. Update the build recipe in [`ci/build_container/build_recipes`](../ci/build_container/build_recipes).
+3. `bazel test //test/...`

bazel/envoy_build_system.bzl

@@ -1,4 +1,4 @@
-load("@protobuf_git//:protobuf.bzl", "cc_proto_library")
+load("@protobuf_bzl//:protobuf.bzl", "cc_proto_library")
 
 ENVOY_COPTS = [
     # TODO(htuch): Remove this when Bazel bringup is done.