debian-mirror-gitlab/doc/administration/high_availability/load_balancer.md

117 lines
5 KiB
Markdown
Raw Normal View History

2016-06-02 11:05:42 +05:30
# Load Balancer for GitLab HA
In an active/active GitLab configuration, you will need a load balancer to route
traffic to the application servers. The specifics on which load balancer to use
or the exact configuration is beyond the scope of GitLab documentation. We hope
that if you're managing HA systems like GitLab you have a load balancer of
choice already. Some examples including HAProxy (open-source), F5 Big-IP LTM,
and Citrix Net Scaler. This documentation will outline what ports and protocols
you need to use with GitLab.
2019-07-07 11:18:12 +05:30
## SSL
How will you handle SSL in your HA environment? There are several different
options:
- Each application node terminates SSL
- The load balancer(s) terminate SSL and communication is not secure between
the load balancer(s) and the application nodes
- The load balancer(s) terminate SSL and communication is *secure* between the
load balancer(s) and the application nodes
### Application nodes terminate SSL
Configure your load balancer(s) to pass connections on port 443 as 'TCP' rather
than 'HTTP(S)' protocol. This will pass the connection to the application nodes
Nginx service untouched. Nginx will have the SSL certificate and listen on port 443.
See [Nginx HTTPS documentation](https://docs.gitlab.com/omnibus/settings/nginx.html#enable-https)
for details on managing SSL certificates and configuring Nginx.
### Load Balancer(s) terminate SSL without backend SSL
Configure your load balancer(s) to use the 'HTTP(S)' protocol rather than 'TCP'.
The load balancer(s) will then be responsible for managing SSL certificates and
terminating SSL.
Since communication between the load balancer(s) and GitLab will not be secure,
there is some additional configuration needed. See
[Nginx Proxied SSL documentation](https://docs.gitlab.com/omnibus/settings/nginx.html#supporting-proxied-ssl)
for details.
### Load Balancer(s) terminate SSL with backend SSL
Configure your load balancer(s) to use the 'HTTP(S)' protocol rather than 'TCP'.
The load balancer(s) will be responsible for managing SSL certificates that
end users will see.
Traffic will also be secure between the load balancer(s) and Nginx in this
scenario. There is no need to add configuration for proxied SSL since the
connection will be secure all the way. However, configuration will need to be
added to GitLab to configure SSL certificates. See
[Nginx HTTPS documentation](https://docs.gitlab.com/omnibus/settings/nginx.html#enable-https)
for details on managing SSL certificates and configuring Nginx.
## Ports
### Basic ports
2016-06-02 11:05:42 +05:30
2017-08-17 22:00:37 +05:30
| LB Port | Backend Port | Protocol |
| ------- | ------------ | --------------- |
| 80 | 80 | HTTP [^1] |
| 443 | 443 | TCP or HTTPS [^1] [^2] |
| 22 | 22 | TCP |
2016-06-02 11:05:42 +05:30
2019-07-07 11:18:12 +05:30
### GitLab Pages Ports
2016-06-02 11:05:42 +05:30
2019-07-07 11:18:12 +05:30
If you're using GitLab Pages with custom domain support you will need some
2017-08-17 22:00:37 +05:30
additional port configurations.
GitLab Pages requires a separate virtual IP address. Configure DNS to point the
`pages_external_url` from `/etc/gitlab/gitlab.rb` at the new virtual IP address. See the
2016-06-02 11:05:42 +05:30
[GitLab Pages documentation][gitlab-pages] for more information.
| LB Port | Backend Port | Protocol |
| ------- | ------------ | -------- |
2017-08-17 22:00:37 +05:30
| 80 | Varies [^3] | HTTP |
| 443 | Varies [^3] | TCP [^4] |
2016-06-02 11:05:42 +05:30
2019-07-07 11:18:12 +05:30
### Alternate SSH Port
2016-06-02 11:05:42 +05:30
Some organizations have policies against opening SSH port 22. In this case,
it may be helpful to configure an alternate SSH hostname that allows users
2017-08-17 22:00:37 +05:30
to use SSH on port 443. An alternate SSH hostname will require a new virtual IP address
2016-06-02 11:05:42 +05:30
compared to the other GitLab HTTP configuration above.
Configure DNS for an alternate SSH hostname such as altssh.gitlab.example.com.
| LB Port | Backend Port | Protocol |
| ------- | ------------ | -------- |
| 443 | 22 | TCP |
---
Read more on high-availability configuration:
1. [Configure the database](database.md)
1. [Configure Redis](redis.md)
1. [Configure NFS](nfs.md)
1. [Configure the GitLab application servers](gitlab.md)
2017-08-17 22:00:37 +05:30
[^1]: [Web terminal](../../ci/environments.md#web-terminals) support requires
your load balancer to correctly handle WebSocket connections. When using
HTTP or HTTPS proxying, this means your load balancer must be configured
to pass through the `Connection` and `Upgrade` hop-by-hop headers. See the
[web terminal](../integration/terminal.md) integration guide for
more details.
[^2]: When using HTTPS protocol for port 443, you will need to add an SSL
2016-06-02 11:05:42 +05:30
certificate to the load balancers. If you wish to terminate SSL at the
GitLab application server instead, use TCP protocol.
2017-08-17 22:00:37 +05:30
[^3]: The backend port for GitLab Pages depends on the
2016-06-02 11:05:42 +05:30
`gitlab_pages['external_http']` and `gitlab_pages['external_https']`
setting. See [GitLab Pages documentation][gitlab-pages] for more details.
2017-08-17 22:00:37 +05:30
[^4]: Port 443 for GitLab Pages should always use the TCP protocol. Users can
2016-06-02 11:05:42 +05:30
configure custom domains with custom SSL, which would not be possible
if SSL was terminated at the load balancer.
2017-08-17 22:00:37 +05:30
[gitlab-pages]: ../pages/index.md