Improve Google Cloud DNS docs (#230)

- Markdown formatting improvements
- Added note about newlines in private key
This commit is contained in:
Patrick G 2017-10-11 10:10:23 -04:00 committed by Craig Peterson
parent 326e3a803c
commit f753c5a700

View file

@ -9,7 +9,8 @@ jsId: GCLOUD
## Configuration
For Google cloud authentication, DNSControl requires a JSON 'Service Account Key' for your project. Copy the full JSON object into your `creds.json` like so:
For Google cloud authentication, DNSControl requires a JSON 'Service Account Key' for your project. Newlines in the private key need to be replaced with `\n`.Copy the full JSON object into your `creds.json` like so:
{% highlight json %}
{
"gcloud": {
@ -32,11 +33,9 @@ For Google cloud authentication, DNSControl requires a JSON 'Service Account Key
See [the Activation section](#activation) for some tips on obtaining these credentials.
## Metadata
This provider does not recognize any special metadata fields unique to google cloud dns.
## Usage
Use this provider like any other DNS Provider:
{% highlight js %}
@ -49,7 +48,6 @@ D("example.tld", REG_NAMECOM, DnsProvider(GCLOUD),
{%endhighlight%}
## Activation
1. Go to your app-engine console and select the appropriate project.
2. Go to "API Manager > Credentials", and create a new "Service Account Key"
@ -59,7 +57,6 @@ D("example.tld", REG_NAMECOM, DnsProvider(GCLOUD),
4. Download the JSON key and copy it into your `creds.json` under the name of your gcloud provider.
## New domains
If a domain does not exist in your Google Cloud DNS account, DNSControl
will *not* automatically add it. You'll need to do that via the
will *not* automatically add it with the `create-domains` account. You'll need to do that via the
control panel manually.