Anthos clusters on VMware is now Google Distributed Cloud (software only) for VMware. For more information, see the product overview.

IP block file

This page describes the fields in an IP block file, which is used in the setup of Google Distributed Cloud.

You use an IP block file to describe a set of machines and the network that the machines are on. Here are some examples of how you would use an IP block file:

List the hostnames and static IP addresses for the nodes in your admin cluster.
List the hostnames and static IP addresses for the nodes in a user cluster.
List the hostnames and static IP addresses for the VMs that run the bundled Seesaw load balancer for your admin cluster.
List the hostnames and static IP addresses for the VMs that run the bundled Seesaw load balancer for a user cluster.

Template

Click to see a template for an IP block file.

  blocks:
  - netmask: ""
    gateway: ""
    ips:
    - ip: ""
      hostname: ""
    - ip: ""
      hostname: ""
    ...

Filling in the fields in an IP block file

`blocks`

An array of objects, each of which describes a set of hosts.

`blocks[i].netmask`

String. The subnet mask for the set of hosts. For example:

blocks:
- netmask: "255.255.252.0"

`blocks[i].gateway`

String. The address of the default gateway for the set of hosts. For example:

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"

`blocks[i].ips`

An array of objects. Each object has an individual IP address or a CIDR block of IP addresses. If the object has an individual IP address, it can also have a hostname.

For example:

blocks:
- netmask: "255.255.252.0"
  gateway: "172.16.23.254"
  ips:
  - ip: 172.16.20.10
    hostname: admin-host1
  - ip: 172.16.20.11
    hostname: admin-host2
  - ip: 172.16.20.12/30

The preceding example specifies six IP addresses: two individual addresses and a CIDR block of four addresses.

If you set ip to a CIDR block, do not specify a value for hostname.

When you do not specify a value for hostname, Google Distributed Cloud uses the VM's name from vSphere as the hostname.

Old fields

Previous versions of Google Distributed Cloud used a hostconfig section in the IP block file:

hostconfig:
  dns: ""
  tod: ""
  otherdns:
  - ""
  ...
  othertod:
  - ""
  ...
  searchdomainsfordns:
  - ""
  ...

Do not provide a hostconfig section in your IP block file. Instead, fill in the network.hostConfig section of your admin cluster configuration file or user cluster configuration file.

If you fill in the network.hostConfig section of a cluster configuration file, Google Distributed Cloud ignores the hostconfig sections of all IP block files associated with the cluster.

If you do not fill in the network.hostConfig section of a cluster configuration file, then for backward compatibility, Google Distributed Cloud reads the hostconfig sections of the IP block files associated with the cluster.