network
settings.network.*
)Topic list
Setting list for settings.network
settings.network.hostname
settings.network.hosts
settings.network.https-proxy
settings.network.no-proxy
Topics
Proxy Settings
The proxy settings configure the behaviour of several services depending on your variant:
- On all variants proxy settings affect containerd.service and host-containerd.service.
- On Kubernetes variants (
*-k8s-*
) proxy settings also affect the kubelet.service. - On ECS variants (
*-ecs-*
and*-ecs-2-*
) proxy settings also affect the docker.service and the ecs.service.
Settings
Full Reference
settings.network.hostname
Sets the hostname of the node to the defined value.
Typically, you do not need to change this setting; in the majority of the cases the default will suffice.
Warning
On Kubernetes variants changing settings.network.hostname
at runtime (as opposed to with user data) may cause issues with kubelet registration.
Default: If unset, DNS reverse lookup determines the hostname. If DNS reverse lookup fails, the hostname is the IP address of the node.
settings.network.hosts
A mapping of IP addresses to domain names.
This setting modifies the node’s /etc/hosts
file.
Note
This setting does not typically impact name resolution for orchestrated containers.
[settings.network]
hosts =[
["10.0.0.0", ["test.example.com", "test1.example.com"] ],
["10.1.1.1", ["test2.example.com"] ]
]
# results in a `/etc/hosts` file:
# 10.0.0.0 test.example.com test1.example.com
# 10.1.1.1 test2.example.com
# Repeated entries are merged (including loopback entries), with the first aliases listed taking precedence.
[settings.network]
hosts = [
["10.0.0.0", ["test.example.com", "test1.example.com"]],
["10.1.1.1", ["test2.example.com"]],
["10.0.0.0", ["test3.example.com"]],
]
# results in `/etc/hosts` file:
# 10.0.0.0 test.example.com test1.example.com test3.example.com
# 10.1.1.1 test2.example.com
- Name resolution for ECS orchestrated containers.
- Name resolution for Kubernetes orchestrated containers.
settings.network.https-proxy
The HTTPS proxy server used by services listed under proxy settings section.
Accepted values:- A host name (with an optional port number)
- An IP address (with an optional port number)
[settings.network]
https-proxy = "1.2.3.4:8080"
apiclient set settings.network.https-proxy="1.2.3.4:8080"
settings.network.no-proxy
A list of hosts that Bottlerocket will excluded from proxying.
The no-proxy list automatically includes entries for localhost
.
On Kubernetes variants (*-k8s-*
) the no-proxy lists includes the Kubernetes API server endpoint as well as other commonly used Kubernetes DNS suffixes.
- List of host names and IP addresses
[settings.network]
no-proxy = ["localhost", "127.0.0.1"]
apiclient apply <<EOF
[settings.network]
no-proxy = ["localhost", "127.0.0.1"]
EOF