Refer to configuration file for how to configure Petasos.
For fixed routing, the service block in Petasos' configuration should look similar to the example below:
service:
defaultScheme: http
fixed:
- http://TALARIA_HOSTNAME:PRIMARY_PORT
- http://TALARIA_HOSTNAME:PRIMARY_PORT
Where TALARIA_HOSTNAME is your Talaria DNS record, docker container, or ip address listening on the
PRIMARY_PORT.
NOTE: if you have domain or host certificates available, we recommend always running the service (and all components in the service) in https mode.
For a consul managed list of Talarias, the Petasos configuration should look similar to the example below:
service:
defaultScheme: http
consul:
client:
address: "CONSUL_ADDRESS:8500"
scheme: "http"
waitTime: "30s"
disableGenerateID: true
watches:
-
service: "talaria"
passingOnly: true
vnodeCount: 211
Where CONSUL_ADDRESS is your Consul DNS record, docker container, or ip address.
Petasos is now using consul to watch for Talarias.
NOTE: if you have certs available, change http to https. HTTP should never be run in production.
curl -i HOSTNAME:HEALTH_PORT/health
$ curl -i localhost:6401/health
HTTP/1.1 200 OK
Content-Type: application/json
X-Petasos-Build: development
X-Petasos-Flavor: development
X-Petasos-Region: local
X-Petasos-Server: localhost
X-Petasos-Start-Time: 26 Aug 19 18:43 UTC
Date: Mon, 26 Aug 2019 19:32:48 GMT
Content-Length: 427
Connection: close
{"CurrentMemoryUtilizationActive":900415488,"CurrentMemoryUtilizationAlloc":3725928,"CurrentMemoryUtilizationHeapSys":66224128,"MaxMemoryUtilizationActive":946319360,"MaxMemoryUtilizationAlloc":3814840,"MaxMemoryUtilizationHeapSys":66322432,"PayloadsOverHundred":0,"PayloadsOverTenThousand":0,"PayloadsOverThousand":0,"PayloadsOverZero":0,"TotalRequestsDenied":0,"TotalRequestsReceived":0,"TotalRequestsSuccessfullyServiced":0}
curl -i -H "X-Webpa-Device-Name: DEVICE_ID" HOSTNAME:PRIMARY_PORT/api/v2/device
Where HOSTNAME is your DNS record, docker container, or ip address listening on the
PRIMARY_PORT. Where DEVICE_ID is the device that is connected to Talaria.
$ curl -i -H "X-Webpa-Device-Name:mac:112233445566" localhost:6400/api/v2/device
HTTP/1.1 307 Temporary Redirect
Content-Type: text/html; charset=utf-8
Location: http://talaria-0:6200/api/v2/device
X-Petasos-Build: development
X-Petasos-Flavor: development
X-Petasos-Region: local
X-Petasos-Server: localhost
X-Petasos-Start-Time: 26 Aug 19 18:43 UTC
Date: Mon, 26 Aug 2019 19:35:12 GMT
Content-Length: 71
<a href="http://talaria-0:6200/api/v2/device">Temporary Redirect</a>.
The most common error is conflicting TLS configuration.
Petasos is up and running now; let's stand up scytale.
This documentation is open-source. Please help improve it by filing issues or pull requests.