openstack-helm/doc/source/install/common-requirements.rst
Drew Walters 0f4958d6f9 Docs: update proxy troubleshooting guide
Currently, the proxy troubleshooting guide does not include the IP
address of the Kubernetes API in the defined environment or Ansible
playbook variables. This causes deployments to fail when requests are
routed through proxy servers. This change adds a proxy configuration
section to the beginning of the installation guide and includes the
process of adding the Kubernetes API IP address to the environment and
Ansible playbook variables. It also removes the unecessary sections from
the troubleshooting guide and upgrades the note about resolv.conf being
overwritten to a warning.

Change-Id: I1ff753517b387027f0cc052b18e8822b638cfb4d
2018-08-08 08:06:40 -05:00

1.9 KiB

Commmon Deployment Requirements

Passwordless Sudo

Throughout this guide the assumption is that the user is: ubuntu. Because this user has to execute root level commands remotely to other nodes, it is advised to add the following lines to /etc/sudoers for each node:

root    ALL=(ALL) NOPASSWD: ALL
ubuntu  ALL=(ALL) NOPASSWD: ALL

Latest Version Installs

On the host or master node, install the latest versions of Git, CA Certs & Make if necessary

../../../tools/deployment/developer/common/000-install-packages.sh

Proxy Configuration

Note

This guide assumes that users wishing to deploy behind a proxy have already defined the conventional proxy environment variables http_proxy, https_proxy, and no_proxy.

In order to deploy OpenStack-Helm behind corporate proxy servers, add the following entries to openstack-helm-infra/tools/gate/devel/local-vars.yaml.

proxy:
  http: http://username:password@host:port
  https: https://username:password@host:port
  noproxy: 127.0.0.1,localhost,172.17.0.1,.svc.cluster.local

Note

The .svc.cluster.local address is required to allow the OpenStack client to communicate without being routed through proxy servers. The IP address 172.17.0.1 is the advertised IP address for the Kubernetes API server. Replace the addresses if your configuration does not match the one defined above.

Add the address of the Kubernetes API, 172.17.0.1, and .svc.cluster.local to your no_proxy and NO_PROXY environment variables.

export no_proxy=${no_proxy},172.17.0.1,.svc.cluster.local
export NO_PROXY=${NO_PROXY},172.17.0.1,.svc.cluster.local