## Google Cloud DNS provider for octoDNS
An [octoDNS](https://github.com/octodns/octodns/) provider that targets [Google Cloud DNS](https://cloud.google.com/dns).
### Installation
#### Command line
```
pip install octodns-googlecloud
```
#### requirements.txt/setup.py
Pinning specific versions or SHAs is recommended to avoid unplanned upgrades.
##### Versions
```
# Start with the latest versions and don't just copy what's here
octodns==0.9.14
octodns-googlecloud==0.0.1
```
##### SHAs
```
# Start with the latest/specific versions and don't just copy what's here
-e git+https://git@github.com/octodns/octodns.git@9da19749e28f68407a1c246dfdf65663cdc1c422#egg=octodns
-e git+https://git@github.com/octodns/octodns-googlecloud.git@ec9661f8b335241ae4746eea467a8509205e6a30#egg=octodns_googlecloud
```
### Configuration
```yaml
providers:
googlecloud:
class: octodns_googlecloud.GoogleCloudProvider
# Credentials file for a service_account or other account can be
# specified with the GOOGLE_APPLICATION_CREDENTIALS environment
# variable. (https://console.cloud.google.com/apis/credentials)
#
# The project to work on (not required)
# project: foobar
#
# The File with the google credentials (not required). If used, the
# "project" parameter needs to be set, else it will fall back to the
# "default credentials"
# credentials_file: ~/google_cloud_credentials_file.json
#
# GoogleCloudProvider submits changes in batches. The default batch size
# is 1000, which is also roughly the maximum size that google supports.
# If your plan & apply makes more than batch_size changes they will be
# broken up into smaller sets of at most that size.
# batch_size: 1000
```
### Support Information
#### Records
GoogleCloudProvider supports A, AAAA, CAA, CNAME, MX, NAPTR, NS, PTR, SPF, SRV, and TXT
#### Root NS records
GoogleCloudProvider support full root NS record management
#### Dynamic
GoogleCloudProvider does not support dynamic records.
### Development
See the [/script/](/script/) directory for some tools to help with the development process. They generally follow the [Script to rule them all](https://github.com/github/scripts-to-rule-them-all) pattern. Most useful is `./script/bootstrap` which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.
Raw data
{
"_id": null,
"home_page": "https://github.com/octodns/octodns-googlecloud",
"name": "octodns-googlecloud",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Ross McFarland",
"author_email": "rwmcfa1@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/31/db/1ccb57d2d296f60723b101bc171bfd22ff0b83b5099c97bfc0cccbcb204c/octodns-googlecloud-0.0.3.tar.gz",
"platform": null,
"description": "## Google Cloud DNS provider for octoDNS\n\nAn [octoDNS](https://github.com/octodns/octodns/) provider that targets [Google Cloud DNS](https://cloud.google.com/dns).\n\n### Installation\n\n#### Command line\n\n```\npip install octodns-googlecloud\n```\n\n#### requirements.txt/setup.py\n\nPinning specific versions or SHAs is recommended to avoid unplanned upgrades.\n\n##### Versions\n\n```\n# Start with the latest versions and don't just copy what's here\noctodns==0.9.14\noctodns-googlecloud==0.0.1\n```\n\n##### SHAs\n\n```\n# Start with the latest/specific versions and don't just copy what's here\n-e git+https://git@github.com/octodns/octodns.git@9da19749e28f68407a1c246dfdf65663cdc1c422#egg=octodns\n-e git+https://git@github.com/octodns/octodns-googlecloud.git@ec9661f8b335241ae4746eea467a8509205e6a30#egg=octodns_googlecloud\n```\n\n### Configuration\n\n```yaml\nproviders:\n googlecloud:\n class: octodns_googlecloud.GoogleCloudProvider\n # Credentials file for a service_account or other account can be\n # specified with the GOOGLE_APPLICATION_CREDENTIALS environment\n # variable. (https://console.cloud.google.com/apis/credentials)\n #\n # The project to work on (not required)\n # project: foobar\n #\n # The File with the google credentials (not required). If used, the\n # \"project\" parameter needs to be set, else it will fall back to the\n # \"default credentials\"\n # credentials_file: ~/google_cloud_credentials_file.json\n #\n # GoogleCloudProvider submits changes in batches. The default batch size\n # is 1000, which is also roughly the maximum size that google supports.\n # If your plan & apply makes more than batch_size changes they will be\n # broken up into smaller sets of at most that size.\n # batch_size: 1000\n```\n\n### Support Information\n\n#### Records\n\nGoogleCloudProvider supports A, AAAA, CAA, CNAME, MX, NAPTR, NS, PTR, SPF, SRV, and TXT\n\n#### Root NS records\n\nGoogleCloudProvider support full root NS record management\n\n#### Dynamic\n\nGoogleCloudProvider does not support dynamic records.\n\n### Development\n\nSee the [/script/](/script/) directory for some tools to help with the development process. They generally follow the [Script to rule them all](https://github.com/github/scripts-to-rule-them-all) pattern. Most useful is `./script/bootstrap` which will create a venv and install both the runtime and development related requirements. It will also hook up a pre-commit hook that covers most of what's run by CI.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Google Cloud DNS provider for octoDNS",
"version": "0.0.3",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "34ca0e59eed3249339097f27ddd43f431a6229e7e6aa374d391a9a68a3b01e2a",
"md5": "db2c535a2388a5003c82baffb6061b49",
"sha256": "0b3e5cca1bb1158d61fc65a1f0f0d301ddd3568551cde83532bb2d4b4c88a513"
},
"downloads": -1,
"filename": "octodns_googlecloud-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "db2c535a2388a5003c82baffb6061b49",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 5823,
"upload_time": "2023-02-08T16:37:51",
"upload_time_iso_8601": "2023-02-08T16:37:51.172361Z",
"url": "https://files.pythonhosted.org/packages/34/ca/0e59eed3249339097f27ddd43f431a6229e7e6aa374d391a9a68a3b01e2a/octodns_googlecloud-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "31db1ccb57d2d296f60723b101bc171bfd22ff0b83b5099c97bfc0cccbcb204c",
"md5": "09604d3edea80595ed335bb90ac01119",
"sha256": "858e59d5a9b3d3f0039fd47f62d7e8d591ca0f7a924b7bf506f5d9568d7b5602"
},
"downloads": -1,
"filename": "octodns-googlecloud-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "09604d3edea80595ed335bb90ac01119",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 9933,
"upload_time": "2023-02-08T16:37:52",
"upload_time_iso_8601": "2023-02-08T16:37:52.390294Z",
"url": "https://files.pythonhosted.org/packages/31/db/1ccb57d2d296f60723b101bc171bfd22ff0b83b5099c97bfc0cccbcb204c/octodns-googlecloud-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-08 16:37:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "octodns",
"github_project": "octodns-googlecloud",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "octodns-googlecloud"
}
JSON
