README
¶
Extensible Service Proxy tools
This repository hosts helper tools for the Extensible Service Proxy.
These tools are not official Google products.
ESP CLI
ESP command line tool (espcli) lets you try out the Extensible Service Proxy on a Kubernetes cluster using a simple two-step deployment process. ESP CLI depends on kubectl and its active kube configuration. You also need a Google Cloud Platform project.
Quick Example
First, bring up a Kubernetes deployment consisting of echo service and echo pods on your GCP cluster:
kubectl create -f echo_http.yaml
Next, run the following command to inject ESP container into echo pods and create a new service called endpoints:
espcli deploy echo endpoints --project MY_PROJECT -e LoadBalancer
Replace MY_PROJECT above with the name of your GCP project.
Then make a request to the external IP address of endpoints service as follows:
curl -d '{"message":"hello world"}' -H "content-type:application/json" http://ENDPOINTS_IP/echo
Go to the Endpoints UI and see the detailed logging and monitoring information for the newly created API.
Build instructions
We use Bazel to build the ESP tools.
To build espcli, run the following command:
bazel build :espcli
This command fetches all required dependencies and produces a single binary
bazel-bin/espcli. To read more about its usage and flags,
please consult:
bazel run :espcli -- help
Contributing
Your contributions are welcome. Please follow the contributor guidelines.
Documentation
¶
Overview ¶
Copyright 2016 Google Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. /////////////////////////////////////////////////////////////////////////
Extensible Service Proxy helper CLI
Source Files
Directories