mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 21:46:22 +01:00
142 lines
4.5 KiB
Plaintext
142 lines
4.5 KiB
Plaintext
// Module included in the following assemblies:
|
||
//
|
||
// * installing/installing-with-agent-based-installer/preparing-to-install-with-agent-based-installer.adoc
|
||
|
||
:_mod-docs-content-type: CONCEPT
|
||
[id="agent-install-networking_{context}"]
|
||
= About networking
|
||
|
||
The *rendezvous IP* must be known at the time of generating the agent ISO, so that during the initial boot all the hosts can check in to the assisted service.
|
||
If the IP addresses are assigned using a Dynamic Host Configuration Protocol (DHCP) server, then the `rendezvousIP` field must be set to an IP address of one of the hosts that will become part of the deployed control plane.
|
||
In an environment without a DHCP server, you can define IP addresses statically.
|
||
|
||
In addition to static IP addresses, you can apply any network configuration that is in NMState format. This includes VLANs and NIC bonds.
|
||
|
||
[NOTE]
|
||
====
|
||
By default, Podman uses a subnet of `10.88.0.0/16` as a bridge network.
|
||
Do not set the `network.machineNetwork.cidr` parameter to include this address range, otherwise a conflict causes the cluster installation to fail.
|
||
====
|
||
|
||
[id="agent-install-networking-DHCP_{context}"]
|
||
== DHCP
|
||
|
||
.Preferred method: `install-config.yaml` and `agent-config.yaml`
|
||
|
||
You must specify the value for the `rendezvousIP` field. The `networkConfig` fields can be left blank:
|
||
|
||
.Sample agent-config.yaml.file
|
||
|
||
[source,yaml]
|
||
----
|
||
apiVersion: v1alpha1
|
||
kind: AgentConfig
|
||
metadata:
|
||
name: sno-cluster
|
||
rendezvousIP: 192.168.111.80 <1>
|
||
----
|
||
<1> The IP address for the rendezvous host.
|
||
|
||
[id="agent-install-networking-static_{context}"]
|
||
== Static networking
|
||
|
||
.. Preferred method: `install-config.yaml` and `agent-config.yaml`
|
||
|
||
+
|
||
.Sample agent-config.yaml.file
|
||
+
|
||
[source,yaml]
|
||
----
|
||
cat > agent-config.yaml << EOF
|
||
apiVersion: v1alpha1
|
||
kind: AgentConfig
|
||
metadata:
|
||
name: sno-cluster
|
||
rendezvousIP: 192.168.111.80 <1>
|
||
hosts:
|
||
- hostname: master-0
|
||
interfaces:
|
||
- name: eno1
|
||
macAddress: 00:ef:44:21:e6:a5 <2>
|
||
networkConfig:
|
||
interfaces:
|
||
- name: eno1
|
||
type: ethernet
|
||
state: up
|
||
mac-address: 00:ef:44:21:e6:a5
|
||
ipv4:
|
||
enabled: true
|
||
address:
|
||
- ip: 192.168.111.80 <3>
|
||
prefix-length: 23 <4>
|
||
dhcp: false
|
||
dns-resolver:
|
||
config:
|
||
server:
|
||
- 192.168.111.1 <5>
|
||
routes:
|
||
config:
|
||
- destination: 0.0.0.0/0
|
||
next-hop-address: 192.168.111.1 <6>
|
||
next-hop-interface: eno1
|
||
table-id: 254
|
||
EOF
|
||
----
|
||
<1> If a value is not specified for the `rendezvousIP` field, one address will be chosen from the static IP addresses specified in the `networkConfig` fields.
|
||
<2> The MAC address of an interface on the host, used to determine which host to apply the configuration to.
|
||
<3> The static IP address of the target bare metal host.
|
||
<4> The static IP address’s subnet prefix for the target bare metal host.
|
||
<5> The DNS server for the target bare metal host.
|
||
<6> Next hop address for the node traffic. This must be in the same subnet as the IP address set for the specified interface.
|
||
|
||
+
|
||
.. Optional method: {ztp} manifests
|
||
|
||
+
|
||
The optional method of the {ztp} custom resources comprises 6 custom resources; you can configure static IPs in the `nmstateconfig.yaml` file.
|
||
|
||
+
|
||
[source,yaml]
|
||
----
|
||
apiVersion: agent-install.openshift.io/v1beta1
|
||
kind: NMStateConfig
|
||
metadata:
|
||
name: master-0
|
||
namespace: openshift-machine-api
|
||
labels:
|
||
cluster0-nmstate-label-name: cluster0-nmstate-label-value
|
||
spec:
|
||
config:
|
||
interfaces:
|
||
- name: eth0
|
||
type: ethernet
|
||
state: up
|
||
mac-address: 52:54:01:aa:aa:a1
|
||
ipv4:
|
||
enabled: true
|
||
address:
|
||
- ip: 192.168.122.2 <1>
|
||
prefix-length: 23 <2>
|
||
dhcp: false
|
||
dns-resolver:
|
||
config:
|
||
server:
|
||
- 192.168.122.1 <3>
|
||
routes:
|
||
config:
|
||
- destination: 0.0.0.0/0
|
||
next-hop-address: 192.168.122.1 <4>
|
||
next-hop-interface: eth0
|
||
table-id: 254
|
||
interfaces:
|
||
- name: eth0
|
||
macAddress: 52:54:01:aa:aa:a1 <5>
|
||
----
|
||
<1> The static IP address of the target bare metal host.
|
||
<2> The static IP address’s subnet prefix for the target bare metal host.
|
||
<3> The DNS server for the target bare metal host.
|
||
<4> Next hop address for the node traffic. This must be in the same subnet as the IP address set for the specified interface.
|
||
<5> The MAC address of an interface on the host, used to determine which host to apply the configuration to.
|
||
|
||
The rendezvous IP is chosen from the static IP addresses specified in the `config` fields.
|