From f753c5a700397c2962fe56f8a8be8c50b668cf69 Mon Sep 17 00:00:00 2001 From: Patrick G Date: Wed, 11 Oct 2017 10:10:23 -0400 Subject: [PATCH] Improve Google Cloud DNS docs (#230) - Markdown formatting improvements - Added note about newlines in private key --- docs/_providers/gcloud.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/docs/_providers/gcloud.md b/docs/_providers/gcloud.md index 0b4b2943c..4edeba087 100644 --- a/docs/_providers/gcloud.md +++ b/docs/_providers/gcloud.md @@ -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.