Service Discovery

Load Balancer

The load balancer hostname for a particular Service can be found using convox services.

Connecting to this hostname will distribute traffic across all processes of a given Service.

For an app named myapp with a convox.yml like this:

    services:
      auth:
        port: 5000
      web:
        port: 3000

You would see a convox services output similar to this:

    $ convox services
    SERVICE  DOMAIN                                PORTS
    auth     auth.myapp.0a1b2c3d4e5f.convox.cloud  443:5000
    web      web.myapp.0a1b2c3d4e5f.convox.cloud   443:3000

The web Service could reach the auth Service using https://auth.myapp.0a1b2c3d4e5f.convox.cloud:443

Note that both of these Services are available to the public internet.

Internal Services

You can make a Service accessible only inside the Rack by setting its internal attribute to true.

For an app named myapp with a convox.yml like this:

    services:
      auth:
        internal: true
        port: 5000
      web:
        port: 3000

You would see a convox services output similar to this:

    $ convox services
    SERVICE  DOMAIN                               PORTS
    auth     auth.myapp.convox.local              5000
    web      web.myapp.0a1b2c3d4e5f.convox.cloud  443:3000

The web Service could reach the auth Service using the following URL:

• http://auth.myapp.convox.local:5000

Note that the internal port of the auth Service is not receiving automatic SSL termination. If you want this connection to be encrypted you would need to handle SSL inside the Service.