Story #15528

[docs] better explain the relationship between API server, controller and nginx in install docs

Added by Peter Amstutz 17 days ago. Updated 9 days ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
-
Target version:
Start date:
Due date:
% Done:

0%

Estimated time:
Story points:
-

Description

Feedback from gitter:

clients will contact port 443
nginx will forward to controller (internal port), controller forwards to the Rails API server (different internal port)

perfect.. Just one comment: wht you write here should be integrated inside the documentation :-)

Also:

This is set in install-api

geo $external_client { ... }

but is actually used in install-controller:

proxy_set_header X-External-Client $external_client;

Both parts should be listed in install-controller, along with a better explanation of what it is used for and the failure mode (keep_services.accessible doesn't work) if it isn't configured correctly.

History

#1 Updated by Peter Amstutz 17 days ago

  • Status changed from New to In Progress

#2 Updated by Peter Amstutz 17 days ago

  • Status changed from In Progress to New
  • Description updated (diff)

#3 Updated by Peter Amstutz 16 days ago

  • Description updated (diff)

#4 Updated by Tom Morris 9 days ago

  • Target version changed from 2019-08-14 Sprint to Arvados Future Sprints
  • Tracker changed from Bug to Story

Also available in: Atom PDF