Chapter 7. Exposing the RHACS portal over HTTP

• To specify an HTTP endpoint you must use an <endpoints_spec>. It is a comma-separated list of single endpoint specifications in the form of <type>@<addr>:<port>, where:

  • type is grpc or http. Using http as type works in most use cases. For advanced use cases, you can either use grpc or omit its value. If you omit the value for type, you can configure two endpoints in your proxy, one for gRPC and the other for HTTP. Both these endpoints point to the same exposed HTTP port on Central. However, most proxies do not support carrying both gRPC and HTTP traffic on the same external port.
  • addr is the IP address to expose Central on. You can omit this, or use localhost or 127.0.0.1 if you need an HTTP endpoint which is only accessible by using port-forwarding.
  • port is the port to expose Central on.

  • The following are several valid <endpoints_spec> values:

    • 8080
    • http@8080
    • :8081
    • grpc@:8081
    • localhost:8080
    • http@localhost:8080
    • http@8080,grpc@8081
    • 8080, grpc@:8081, http@0.0.0.0:8082

Procedure

• Run the following command to specify an HTTP endpoint during the interactive installation process:

  $ roxctl central generate interactive \
    --plaintext-endpoints=<endpoints_spec> 

  1

  1

  Endpoint specifications in the form of <type>@<addr>:<port>. See the Prerequisites section for details.