Skip to content

Commit 3bc612f

Browse files
authored
docs: Update documentation to describe how to use Advanced DR write endpoint. (#1042)
1 parent 2f89504 commit 3bc612f

File tree

1 file changed

+17
-4
lines changed

1 file changed

+17
-4
lines changed

README.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -243,14 +243,27 @@ func connect() {
243243
}
244244
```
245245

246-
### Using DNS domain names to identify instances
246+
### Using Advanced Disaster Recovery and DNS domain names to identify instances
247247

248-
The connector can be configured to use DNS to look up an instance. This would
249-
allow you to configure your application to connect to a database instance, and
250-
centrally configure which instance in your DNS zone.
248+
The connector can be configured to use DNS to look up an instance.
249+
Use a DNS name managed by Cloud SQL [Advanced Disaster Recovery](https://docs.cloud.google.com/sql/docs/mysql/use-advanced-disaster-recovery),
250+
or a domain name that you manage.
251+
252+
#### Using Advanced Recovery Write Endpoint DNS Name
253+
254+
[Advanced Disaster Recovery](https://docs.cloud.google.com/sql/docs/mysql/use-advanced-disaster-recovery)
255+
creates geographically distributed replicas of your Cloud SQL database instance. When you perform
256+
switchover or failover on the database instance, the connector will gracefully disconnect from the
257+
old primary instance and reconnect to the new primary instance.
258+
259+
Follow the instructions in [Connect using Write Endpoint](https://docs.cloud.google.com/sql/docs/mysql/connect-to-instance-using-write-endpoint)
260+
to get the write endpoint DNS name for your primary instance. Then, use this write endpoint DNS
261+
name to configure the connector.
251262

252263
#### Configure your DNS Records
253264

265+
The connector may be configured to use DNS that you define as well.
266+
254267
Add a DNS TXT record for the Cloud SQL instance to a **private** DNS server
255268
or a private Google Cloud DNS Zone used by your application.
256269

0 commit comments

Comments
 (0)