https://slashquery.com/ Recent content on SlashQuery /? Hugo -- gohugo.io en-us Sat, 03 Jun 2017 09:58:25 +0200 https://slashquery.com/post/microservices-using-an-api-gateway/ Sat, 03 Jun 2017 09:58:25 +0200 https://slashquery.com/post/microservices-using-an-api-gateway/ The big picture: (slashquery API Gateway) api.example.com/<path endpoint> | (plugins) (upstream) (microservices) | /home | /* >--[middleware]---[LoadBalancer]--< /home | /home | | /foo | /foo/* >--[middleware]---[LoadBalancer]--< /foo | /foo | | /foo-version-2 (versioning) | /foo/* >--[middleware]---[LoadBalancer]--< /foo-version-2 | /foo-version-2 | | /bar ` /bar/* >--[middleware]---[LoadBalancer]--< /bar /bar More about versioning: https://violetear.org/post/versioning/ The configuration file in YAML format: config: host: ~ # listen all IP's port: 80 resolver: 8. https://slashquery.com/post/build-your-api-gateway/ Sat, 03 Jun 2017 09:57:24 +0200 https://slashquery.com/post/build-your-api-gateway/ Because of the plugins (middleware) is not possible to have a generic binary, therefore after creating the configuration file and based on the plugins defined the gateway needs to be build. Setup Setup go environment https://golang.org/doc/install go >= 1.7 is required For example using $HOME/go for your workspace export GOPATH=$HOME/go Create the directory: mkdir -p $HOME/go/src/github.com/slashquery Clone project into that directory: git clone git@github.com:slashquery/slashquery.git $HOME/go/src/github.com/slashquery/slashquery Create your configuration file and type make CONFIG=/path/to/slashquery. https://slashquery.com/post/slashquery-yaml/ Sat, 03 Jun 2017 09:57:23 +0200 https://slashquery.com/post/slashquery-yaml/ The configuration file is composed of 3 sections: config routes upstreams plugins Example: config: socket: /tmp/slashquery.sock routes: get: path: /get upstream: httpbin methods: - GET plugins: - waf upstream: httpbin: timeout: 5 servers: - httpbin.org plugins: waf: ["github.com/slashquery-plugins/waf", "waf.WAF"] The config allow the following options: debug host port request-id resolver socket https://slashquery.com/post/plugins/ Sat, 03 Jun 2017 09:56:24 +0200 https://slashquery.com/post/plugins/ Plugins are handlers that satisfy the http.Handler. They are declared in the routes section of the configuration file for example: routes: foo: url: http://foo.example.com plugins: # the order of the plugins meters - requestid - waf - cors - prometheus plugins: cors: ["github.com/slashquery-plugins/cors", "cors.CORS"] csrf: ["github.com/slashquery-plugins/csrf", "csrf.CSRF"] prometheus: ["github.com/slashquery-plugins/prometheus", "prometheus.Prometheus"] requestid: ["github.com/slashquery-plugins/requestid", "requestid.RequestID"] waf: ["github.com/slashquery-plugins/waf", "waf.WAF"] The plugins section is a list of plugins each of one defined within a list, for example: https://slashquery.com/post/nginx-and-slashquery-through-unix-socket/ Sat, 03 Jun 2017 09:56:23 +0200 https://slashquery.com/post/nginx-and-slashquery-through-unix-socket/ Nginx configuration: upstream slashquery { server unix:/tmp/slashquery.sock; keepalive 60; } server { listen 80 default_server; listen [::]:80 default_server; server_name _; location / { proxy_pass http://slashquery; proxy_http_version 1.1; # for keep-alive proxy_redirect off; proxy_set_header Host $http_host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Real-IP $remote_addr; } } SlashQuery configuration: config: socket: /tmp/slashquery.sock ... When socket is defined host and port are ignored. https://slashquery.com/about/ Sun, 21 May 2017 22:52:45 +0200 https://slashquery.com/about/ What is slashquery ? A pluggable API Gateway In a nutshell is an HTTP reverse proxy that pre-processes the requests before they arrive at their final destination based on custom plugins. Some features: Single binary. Loads configuration from a YAML file. Allows the use of 3rd party handlers (plugins) that satisfy the http.Handler. DNS resolver honoring TTL from the upstream. Load balancer (round robin). Versioning Accept: application/vnd.* Accept or reject(405) based on HTTP Request Methods