Skip to content

Latest commit

 

History

History
40 lines (28 loc) · 2.34 KB

development.md

File metadata and controls

40 lines (28 loc) · 2.34 KB
Raw

Development Guide

Please see the Istio development guide for the common Istio-wide development guidelines.

After which here are other Mixer specific docs you should look at:

Using Mixer locally

The following command runs Mixer locally using local configuration. The default configuration contain adapters like stackdriver that connect to outside systems. If you do not intend to use the adapter for local testing, you should move testdata/config/stackdriver.yaml out of the config directory, otherwise you will see repeated logging of configuration errors.

The local configuration uses a Kubernetes attribute producing adapter. The KUBECONFIG environment variable specifies the location of the Kubernetes configuration. If you do not want to use the Kubernetes adapter, remove testdata/configroot/scopes/global/subjects/global/rules.yml.

KUBECONFIG=${HOME}/.kube/config bazel-bin/cmd/server/mixs server --logtostderr --configStore2URL=fs://$(pwd)/testdata/config --configStoreURL=fs://$(pwd)/testdata/configroot  -v=4

You can also run a simple client to interact with the server:

The following command sends a check request to Mixer. Note that source.ip is an ip address specified as 4 : separated bytes. 192.0.0.2 is encoded as c0:0:0:2 in the example.

bazel-bin/cmd/client/mixc check -v 2 --string_attributes destination.service=abc.ns.svc.cluster.local,source.name=myservice,target.port=8080 --stringmap_attributes "request.headers=clnt:abcd;source:abcd,destination.labels=app:ratings,source.labels=version:v2"   --timestamp_attributes request.time="2017-07-04T00:01:10Z" --bytes_attributes source.ip=c0:0:0:2

Check RPC completed successfully. Check status was OK
  Valid use count: 10000, valid duration: 5m0s

The following command sends a report request to Mixer.

bazel-bin/cmd/client/mixc report -v 2 --string_attributes destination.service=abc.ns.svc.cluster.local,source.name=myservice,target.port=8080 --stringmap_attributes "request.headers=clnt:abc;source:abcd,destination.labels=app:ratings,source.labels=version:v2"  --int64_attributes response.duration=2003,response.size=1024 --timestamp_attributes  request.time="2017-07-04T00:01:10Z" --bytes_attributes source.ip=c0:0:0:2

Report RPC returned OK