Skip to content

Commit 3fce774

Browse files
committed
Add guidance on using cloud-provided DNS server
1 parent 52011fd commit 3fce774

File tree

4 files changed

+18
-0
lines changed

4 files changed

+18
-0
lines changed

modules/installation-about-custom-azure-vnet.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,8 @@ When you deploy a cluster by using an existing VNet, you must perform additional
3232
* VNets
3333
* Network Security Groups
3434

35+
include::snippets/custom-dns-server.adoc[]
36+
3537
If you use a custom VNet, you must correctly configure it and its subnets for the installation program and the cluster to use. The installation program cannot subdivide network ranges for the cluster to use, set route tables for the subnets, or set VNet options like DHCP, so you must do so before you install the cluster.
3638

3739
The cluster must be able to access the resource group that contains the existing VNet and subnets. While all of the resources that the cluster creates are placed in a separate resource group that it creates, some network resources are used from a separate group. Some cluster Operators must be able to access resources in both resource groups. For example, the Machine API controller attaches NICS for the virtual machines that it creates to subnets from the networking resource group.

modules/installation-custom-aws-vpc.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,8 @@ The installation program no longer creates the following components:
3636
* VPC DHCP options
3737
* VPC endpoints
3838

39+
include::snippets/custom-dns-server.adoc[]
40+
3941
If you use a custom VPC, you must correctly configure it and its subnets for the installation program and the cluster to use. See link:https://docs.aws.amazon.com/vpc/latest/userguide/VPC_wizard.html[Amazon VPC console wizard configurations] and link:https://docs.aws.amazon.com/vpc/latest/userguide/working-with-vpcs.html[Work with VPCs and subnets] in the AWS documentation for more information on creating and managing an AWS VPC.
4042

4143
The installation program cannot:

modules/installation-custom-gcp-vpc.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ The installation program does not create the following components:
2020
* Route tables
2121
* VPC network
2222

23+
include::snippets/custom-dns-server.adoc[]
24+
2325
[id="installation-custom-gcp-vpc-validation_{context}"]
2426
== VPC validation
2527

snippets/custom-dns-server.adoc

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
// Text snippet included in the following modules:
2+
//
3+
// * modules/installation-custom-aws-vpc.adoc
4+
// * modules/installation-about-custom-azure-vnet.adoc
5+
// * modules/installation-custom-gcp-vpc.adoc
6+
7+
:_content-type: SNIPPET
8+
9+
[NOTE]
10+
====
11+
The installation program requires that you use the cloud-provided DNS server. Using a custom DNS server is not supported and causes the installation to fail.
12+
====

0 commit comments

Comments
 (0)