e82b40e64b
Put discussion of how to access the API ahead of discussion about how to access other services on the cluster. More clearly distinguish the different kinds of proxies. Explain pros and cons of different approaches better. Remove cluster-admin-oriented documentation from user guide. More links.
79 lines
3.9 KiB
Markdown
79 lines
3.9 KiB
Markdown
# Configuring APIserver ports
|
|
|
|
This document describes what ports the kubernetes apiserver
|
|
may serve on and how to reach them. The audience is
|
|
cluster administrators who want to customize their cluster
|
|
or understand the details.
|
|
|
|
Most questions about accessing the cluster are covered
|
|
in [Accessing the cluster](../docs/accessing-the-cluster.md).
|
|
|
|
|
|
## Ports and IPs Served On
|
|
The Kubernetes API is served by the Kubernetes APIServer process. Typically,
|
|
there is one of these running on a single kubernetes-master node.
|
|
|
|
By default the Kubernetes APIserver serves HTTP on 2 ports:
|
|
1. Localhost Port
|
|
- serves HTTP
|
|
- default is port 8080, change with `-port` flag.
|
|
- defaults IP is localhost, change with `-address` flag.
|
|
- no authentication or authorization checks in HTTP
|
|
- protected by need to have host access
|
|
2. Secure Port
|
|
- default is port 443, change with `-secure_port`
|
|
- default IP is first non-localhost network interface, change with `-public_address_override`
|
|
- serves HTTPS. Set cert with `-tls_cert_file` and key with `-tls_private_key_file`.
|
|
- uses token-file or client-certificate based [authentication](./authentication.md).
|
|
- uses policy-based [authorization](./authorization.md).
|
|
3. Removed: ReadOnly Port
|
|
- For security reasons, this had to be removed. Use the service account feature instead.
|
|
|
|
## Proxies and Firewall rules
|
|
|
|
Additionally, in some configurations there is a proxy (nginx) running
|
|
on the same machine as the apiserver process. The proxy serves HTTPS protected
|
|
by Basic Auth on port 443, and proxies to the apiserver on localhost:8080. In
|
|
these configurations the secure port is typically set to 6443.
|
|
|
|
A firewall rule is typically configured to allow external HTTPS access to port 443.
|
|
|
|
The above are defaults and reflect how Kubernetes is deployed to GCE using
|
|
kube-up.sh. Other cloud providers may vary.
|
|
|
|
## Use Cases vs IP:Ports
|
|
|
|
There are three differently configured serving ports because there are a
|
|
variety of uses cases:
|
|
1. Clients outside of a Kubernetes cluster, such as human running `kubectl`
|
|
on desktop machine. Currently, accesses the Localhost Port via a proxy (nginx)
|
|
running on the `kubernetes-master` machine. Proxy uses bearer token authentication.
|
|
2. Processes running in Containers on Kubernetes that need to do read from
|
|
the apiserver. Currently, these can use a service account.
|
|
3. Scheduler and Controller-manager processes, which need to do read-write
|
|
API operations. Currently, these have to run on the operations on the
|
|
apiserver. Currently, these have to run on the same host as the
|
|
apiserver and use the Localhost Port. In the future, these will be
|
|
switched to using service accounts to avoid the need to be co-located.
|
|
4. Kubelets, which need to do read-write API operations and are necessarily
|
|
on different machines than the apiserver. Kubelet uses the Secure Port
|
|
to get their pods, to find the services that a pod can see, and to
|
|
write events. Credentials are distributed to kubelets at cluster
|
|
setup time.
|
|
|
|
## Expected changes
|
|
- Policy will limit the actions kubelets can do via the authed port.
|
|
- Kubelets will change from token-based authentication to cert-based-auth.
|
|
- Scheduler and Controller-manager will use the Secure Port too. They
|
|
will then be able to run on different machines than the apiserver.
|
|
- A general mechanism will be provided for [giving credentials to
|
|
pods](
|
|
https://github.com/GoogleCloudPlatform/kubernetes/issues/1907).
|
|
- Clients, like kubectl, will all support token-based auth, and the
|
|
Localhost will no longer be needed, and will not be the default.
|
|
However, the localhost port may continue to be an option for
|
|
installations that want to do their own auth proxy.
|
|
|
|
|
|
[]()
|