StackExchange/dnscontrol
1
1
Fork 0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2025-02-22 14:43:01 +08:00
Code Issues Projects Releases Packages Wiki Activity

Improve Google Cloud DNS docs (#230)

Browse source 
- 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
1 changed files with 3 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
docs/_providers/gcloud.md
View file

@ -9,7 +9,8 @@ jsId: GCLOUD
## Configuration ## 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 %} {% highlight json %}
{ {
"gcloud": { "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. See [the Activation section](#activation) for some tips on obtaining these credentials.
## Metadata ## Metadata
This provider does not recognize any special metadata fields unique to google cloud dns. This provider does not recognize any special metadata fields unique to google cloud dns.
## Usage ## Usage
Use this provider like any other DNS Provider: Use this provider like any other DNS Provider:
{% highlight js %} {% highlight js %}
@ -49,7 +48,6 @@ D("example.tld", REG_NAMECOM, DnsProvider(GCLOUD),
{%endhighlight%} {%endhighlight%}
## Activation ## Activation
1. Go to your app-engine console and select the appropriate project. 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" 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. 4. Download the JSON key and copy it into your `creds.json` under the name of your gcloud provider.
## New domains ## New domains
If a domain does not exist in your Google Cloud DNS account, DNSControl 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. control panel manually.